GET /callbacks/{accountname}Returns the name and endpoint URL of the callback listening services registered for a given account.
See also:
About ThingSpace Callback Services
Register a Callback Listeners
Deregister a Callback Listener
GET https://thingspace.verizon.com/api/m2m/v1/callbacks/{accountname}
The account name must be included in the path.
| Parameter Name | Data Type | Description |
|---|---|---|
| accountname required |
string | The name of the account for which a list of registered callback services will be returned. An account name is usually numeric, and must include any leading zeros. |
The request header must contain a current ThingSpace authorization bearer token and a valid VZ-M2M session token, and must set the content-type to JSON.
| Parameter Name | Data Type | Description |
|---|---|---|
| Authorization required |
string | HTTP Authorization bearer token. |
| VZ-M2M-Token required |
string | A valid session token returned by POST /session/login. |
| Content-Type required |
string | Must be application/json. |
None.
Note: The response to this request only includes callback listeners that were registered through the Connectivity Management API.
Status 200
| Parameter Name | Data Type | Description |
|---|---|---|
| accountName | string | The name of the billing account for which callback messages will be sent. |
| serviceName | string | The name of the callback service, which identifies the type and format of messages that will be sent to the registered URL. |
| url | string | The address of the callback listening service where the ThingSpace Platform will send callback messages for the service type. |
| username | string | The username defined when a URL was registered for the callback service, or an empty string if no username was defined. |
| password | string | The password defined when a URL was registered for the callback service, or an empty string if no password was defined. |
The response body will be empty if there are no callback services registered with the account.
[
{
"accountName": "0252012345-00001",
"serviceName": "CarrierService",
"url": "http://10.120.102.147:50569/CallbackListener/Carrier.asmx",
},
{
"accountName": "0252012345-00001",
"password": "drowssap",
"serviceName": "DeviceUsage",
"url": "http://10.120.102.147:50569/CallbackListener/Usage.asmx",
"username": "zaffod"
}
]
Status 400
All error messages are returned in this format:
{
"errorCode": "error code string",
"errorMessage": "error message string"
}
Error codes and messages are listed on the Error Messages page, along with explanations and suggestions for corrective actions.