Upload Modes

File upload storage destinations share a common set of file formats to choose from. Optionally a copy of the Lingo JSON can also be included.

Payload Binary

Raw bytes of the received message uploaded to a file. Will have the raw extension unless otherwise provided.

Payload Hex

Payload bytes encoded to Hexadecimal (Base16) characters and uploaded as ASCII to a file.

Sent utf-8: Hello, world!

File Contents: 48656C6C6F2C20776F726C6421

Payload Base64

Payload bytes encoded to Base64 characters and uploaded as ASCII to a file.

Sent utf-8: Hello, world!

File Contents: SGVsbG8sIHdvcmxkIQ==

Lingo JSON

All upload options have a matching upload option that also uploads a JSON version of the Lingo message format.

For example, with the Lingo Upload mode selected, 'iot/upload/' provided as the directory and a prefix of 'iot-'. Lingo will be uploaded to 'iot/upload/iot-1b59a800-60cb-4c08-b6df-8ec5ef988926.json' as below:

{
  "id": "1b59a800-60cb-4c08-b6df-8ec5ef988926",
  "receivedAt": {
    "year": 2023,
    "month": 10,
    "day": 9,
    "hour": 14,
    "minute": 52,
    "second": 20
  },
  "identity": {
    "accountId": "yJGjpPobLlmOdanVkPWAKYzNMgwVZkrR",
    "subscriber": {
      "id": "XgwyNPpDmebJLWXmwgEoARqxMdZOVGva",
      "type": "SUBSCRIBER_TYPE_SBD",
      "description": ""
    },
    "hardware": {
      "id": "joGRxQrXpzkPJEglMOBydwYZbqmDagNA",
      "type": "HARDWARE_TYPE_ROCKBLOCK",
      "imei": "300234065366010",
      "serial": ""
    },
    "identifier": "300234065366010",
    "thingId": "DgXeoxwVPMyrdOBJeEGlqKRJLbajQkzZ"
  },
  "sbd": {
    "imei": "300234065366010",
    "cdrReference": "3155570006",
    "momsn": 5394,
    "mtmsn": 0,
    "sessionAt": {
      "year": 2023,
      "month": 10,
      "day": 9,
      "hour": 14,
      "minute": 52,
      "second": 19
    },
    "status": "SESSION_STATUS_OK",
    "location": {
      "latitude": 50.84753333333333,
      "longitude": -1.1934833333333335,
      "cep": 8.0
    }
  },
  "message": "JgBrey0iF+ztEQwAAAQBuEQnBA=="
}