Webhooks¶
General Info¶
The endpoints has 15 seconds to accept the event. If a success HTTP status code has not been returned within these 15 seconds, the event will be discarded.
Authentication¶
The webhooks authenticate against the endpoints using HTTP Basic authentication:
POST /location_update
Host: www.example.com
Content-Type: application/json
Authorization: Basic SGVsbG8gV29ybGQ=
The webhooks is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.
Location Update¶
Sample of Location Update:
{ "time": "2017-01-01 01:23:45",
"imsi": "238991234567890",
"imei": "1234567890987654",
"type": "cs",
"country_code": "dk",
"country_code_previous": "de" }
XDR¶
Sample of Voice Data Record:
{ "time": "2017-01-01 01:23:45",
"event_id": "1234567890-1234",
"type": "voice",
"country_code": "dk",
"imsi": "238991234567890"
"operation": "finalize",
"direction": "incoming",
"caller": "4512345678",
"called": "4587654321",
"ringtime": "10",
"billtime": "20",
"duration": "30",
"status": "answered",
"error": null }
Sample of SMS Data Record:
{ "time": "2017-01-01 01:23:45",
"event_id": "1234567890-1234",
"type": "sms",
"country_code": "dk",
"imsi": "238991234567890"
"operation": "finalize",
"direction": "incoming",
"caller": "4512345678",
"called": "4587654321",
"retries": "3",
"error": null }
Sample of Data Data Record:
{ "time": "2017-01-01 01:23:45",
"event_id": "1234567890-1234",
"type": "data",
"country_code": "dk",
"imsi": "238991234567890"
"operation": "finalize",
"download": "4321",
"upload": "1234" }