POST | /ping | Use this for testing whether the service is up and for getting the service's version #. |
---|
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Name | body | string | No | Optional parameter; use this to make sure the service is actually doing something. |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Message | form | string | No | Should return 'Pong' + Name, if specified |
ServiceVersion | form | string | No | The version of the service implementations |
MessageVersion | form | string | No | The version of the message DTOs |
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /ping HTTP/1.1
Host: api.paylock.com
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length
{
name: String
}
HTTP/1.1 200 OK Content-Type: text/jsv Content-Length: length { message: String, serviceVersion: String, messageVersion: String }