Skip to main content

LingoDelivery

Delivery Status Messages generated by the platform to denote successful/unsuccessful Message delivery.

This is most pertinent to the AWS SQS Delivery Destination and its Status Queue

  • id - Unique Identifier for each Message generated by the Customer (or Platform, if not supplied)
  • status - Associated status of the Message submission
    • DELIVERY_SUBMITTED - Submitted to the delivery network
    • DELIVERY_SENT - Sent to the device (IMT only)
    • DELIVERY_ERROR - Unable to deliver
  • at - Time of the Status
  • error - Type of delivery error
    • ERROR_NETWORK_FAILURE - Delivery network suffered an issue
    • ERROR_DELIVERY_INVALID_IDENTIFIER - Could not identify the device
    • ERROR_INVALID_MESSAGE - Message not in a compatible format
  • iridiumMt - For IMT messages (status reported by Iridium)
    • DELIVERY_STATUS_SUCCESS
    • DELIVERY_STATUS_DISCARDED_ON_OVERFLOW - Too many messages in queue
    • DELIVERY_STATUS_NO_RESPONSE_TO_RING - Device could not be reached
    • DELIVERY_STATUS_REGISTRATION_EXPIRED - Device has been unreachable for a long period
    • DELIVERY_STATUS_UNPROVISIONED
    • DELIVERY_STATUS_SUBSCRIPTION_INVALID
    • DELIVERY_STATUS_TOPIC_INVALID
    • DELIVERY_STATUS_NOT_REGISTERED
    • DELIVERY_STATUS_MALFORMED_JSON
  • iridiumSbdMt - For SBD messages (status reported by Iridium)
    • SBD_DELIVERY_STATUS_SUCCESS
    • SBD_DELIVERY_STATUS_QUEUE_FULL
    • SBD_DELIVERY_STATUS_INVALID_IMEI
    • SBD_DELIVERY_STATUS_IMEI_UNKNOWN
    • SBD_DELIVERY_STATUS_PAYLOAD_TOO_LARGE
    • SBD_DELIVERY_STATUS_PAYLOAD_MISSING

Example - Status Message (Success)​

{
  "id": "47ad1db0-a073-4716-95a4-cd490cfdfab6",
  "status": "DELIVERY_SUBMITTED",
  "at": {
    "year": 2023,
    "month": 10,
    "day": 4,
    "hour": 15,
    "minute": 37,
    "second": 10
  }
}

Example - Status Message (Error)​

{
  "id": "47ad1db0-a073-4716-95a4-cd490cfdfab6",
  "status": "DELIVERY_ERROR",
  "at": {
    "year": 2023,
    "month": 10,
    "day": 4,
    "hour": 15,
    "minute": 37,
    "second": 10
  },
  "error": "DELIVERY_ERROR_INVALID_IDENTIFIER"
}

Example - Status Message (Temporary IMT Error)​

{
  "id": "47ad1db0-a073-4716-95a4-cd490cfdfab6",
  "status": "DELIVERY_ERROR",
  "at": {
    "year": 2023,
    "month": 10,
    "day": 4,
    "hour": 15,
    "minute": 37,
    "second": 10
  },
  "error": "ERROR_NETWORK_FAILURE",
  "iridiumMt": "DELIVERY_STATUS_DISCARDED_ON_OVERFLOW"
}