Spire Messages API. Removal of Satellite Name From API Response

Scheduled for Apr 30, 08:00 - 09:00 UTC

Scheduled

Spire Maritime are removing the satellite Name information from Messages API responses by the 1st May 2024.

We are writing to give you notice about the removal of the satellite IDs from the Messages API. Satellite ID values are currently returned as the source value in the AIS message records returned by the Messages API. Satellite ID values will be replaced with the label satellite.

This is demonstrated in the sample message below from the Messages API.

This message shows the satellite ID FM88

"data": [
        {
            "id": "5ecad38c-76b1-30a3-9f96-787eaf5d55fe",
            "nmea": "!AIVDM,1,1,,C,Kp15B=@=MpjiUT?t,0*6D",
            "timestamp": "2023-05-08T07:26:57Z",
            "msg_id": "1683530817_538006069",
            "msg_type": 27,
            "created_at": "2023-05-08T10:00:46.468499284Z",
            "mmsi": 538006069,
            "collection_type": "satellite",
            "source": "FM88",
            "flag": "Marshall Is",
            "flag_short_code": "MH",
            "longitude": -69.16833333333334,
            "latitude": 37.885,

The new message format would be

"data": [
        {
            "id": "5ecad38c-76b1-30a3-9f96-787eaf5d55fe",
            "nmea": "!AIVDM,1,1,,C,Kp15B=@=MpjiUT?t,0*6D",
            "timestamp": "2023-05-08T07:26:57Z",
            "msg_id": "1683530817_538006069",
            "msg_type": 27,
            "created_at": "2023-05-08T10:00:46.468499284Z",
            "mmsi": 538006069,
            "collection_type": "satellite",
            "source": "satellite",
            "flag": "Marshall Is",
            "flag_short_code": "MH",
            "longitude": -69.16833333333334,
            "latitude": 37.885,

The source value changing from a satellite ID value FM88 to the label satellite.

The deadline for this change is 1st May 2024

In the coming weeks we will be issuing new tokens to use with the Messages API that hide satellite ID and can be used to test before swapping to the new configuration. Please prepare to make this change as soon as possible and in plenty time to prevent disruption to your data supply.

In case you would like to discuss how this will impact your service then please reply to this email and we can investigate it further with you

Customer Support
If you have any questions about the change, please reach out to the Spire Technical support team using our Support Portal https://faq.spire.com/support/new or by sending an email to sales.engineering@spire.com

Thanks!
Spire Maritime Support Team

Posted May 17, 2023 - 11:51 UTC

This scheduled maintenance affects: Sense Cloud - Messages API.