Device Location Callbacks

Register a URL to receive callbacks

POST
/loc/v1/callbacks/{accountName}

Provide a URL to receive messages from a ThingSpace callback service.

Authorization

thingspace_oauth VZ-M2M-Token
AuthorizationBearer <token>

This is the ThingSpace token, from Credentials and Tokens is used

In: header

VZ-M2M-Token<token>

M2M Session Token (How to generate an M2M session token?)

In: header

Path Parameters

accountName*string

Account number.

Request Body

*/*

Request to register a callback.

Request to register a callback.

name*CallbackServiceName

The name of the callback service.

Value in

  • "Location"
  • "DeviceLocation"
url*string

The location of your callback listener.

Response Body

application/json

application/json

curl -X POST "https://example.com/loc/v1/callbacks/0000123456-00001" \  -H "Content-Type: */*" \  -d '<name>Location</name>  <url>http://10.120.102.183:50559/CallbackListener/LocationServiceMessages.asmx</url>'
{  "account": "0212312345-00001",  "name": "Location"}