| 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
}