Software Management Callbacks V1

Register a Callback Listener URL

POST
/fota/v1/callbacks/{account}

Registers a URL to receive RESTful messages from a callback service when new firmware versions are available and when upgrades start and finish.

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

account*string

Account identifier in "##########-#####".

Request Body

application/json

Callback details.

Callback details.

name*string

The name of the callback service that you want to subscribe to, which must be 'Fota' for Software Management Services callbacks.

url*string

The address on your server where you have enabled a listening service for Software Management Services callback messages.

Formaturi
username?string

The user name that ThingSpace should return in the callback messages.

password?string

The password that ThingSpace should return in the callback messages.

Response Body

application/json

application/json

curl -X POST "https://example.com/fota/v1/callbacks/0242078689-00001" \  -H "Content-Type: application/json" \  -d '{    "name": "Fota",    "url": "https://10.120.102.183:50559/CallbackListener/FirmwareServiceMessages.asmx"  }'
{  "accountName": "0204563412-00001",  "serviceName": "Fota"}