Messages

Send text to a device

post

Send text or raw data over UDP or TCP to a device with a specific SIM ID.

If the protocol is UDP, the packet will be sent to the receiving port. If the protocol is TCP, a connection will be established with the device on that port and the data will be sent. If the device does not accept incoming connections on that port, the data will be discarded.

Either text or data must be provided, but not both. Use text for string data and data for base64-encoded binary data that will be decoded and sent as raw bytes.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

sim_idstringRequiredExample: 000000001

Body

application/json

anyOptional

or

anyOptional

Responses

200

Message sent successfully

application/json

400

Bad request, invalid parameters or device offline

application/json

post

/messages/{sim_id}

HTTPcURLJavaScriptPython

POST /messages/{sim_id} HTTP/1.1
Host: api.onomondo.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "protocol": "udp",
  "port": 1234,
  "text": "hello world"
}

Send text message via UDPSend binary data via TCP

{
  "id": "46c5e0e3-2739-4b6a-8f78-dc4a936d5861"
}