POST /callbacks
Registers a URL at which an account receives asynchronous responses and other messages from a ThingSpace Platform callback service. The messages are REST messages. You are responsible for creating and running a listening process on your server at that URL to receive and parse the messages.
See also:
GET /callbacks
- Find registered listeners for an accountDELETE /callbacks
- Deregister (delete) listeners for an accountA vz-m2m-token
is required to use these APIs. To obtain a token, please visit Getting Started to get a token.
POST https://thingspace.verizon.com/api/hyper-precise/v1/callbacks?accountNumber={accountNumber}
td>string td>string
Parameter | Data Type | Description |
---|---|---|
name required |
string | The name to be assigned to the listener service. |
url required |
string | Universal Resource Locator. The address of the listener service. |
accountNumber required |
string | A unique identifier for an account. |
Example request:
[
{
"aname": "string",
"name": "string",
"url": "string"
}
]
Status 200
A successful response will display the billing account number (aname
), the name of the callback service (name
) and the address of the callback listening service (url
).
Example response:
[
{
"aname": "string",
"name": "string",
"url": "string"
}
]
Code and Meaning | Format |
---|---|
400 - Bad Request. |
|
401 - Unauthorized request. Access token is missing or invalid. |
|
403 - Forbidden request. |
|
404 - Bad request. Not found. |
|
409 - Bad request. Conflict state. |
|
500 - Internal Server Error. |
|