Documentation link about device messages is broken

[mawh]

https://api.nrfcloud.com/v1#tag/Messages/operation/ListMessages looks like:

The link highlighted in yellow is broken. Where is the documentation about device messages?

[Charlie]

Hi Matt,

It is available here Device messages | nRF Cloud Docs.

Thanks for reporting this issue, I will inform the document writer for a correction.

Best regards,

Charlie

[mawh]

Thanks Charlie. I was hoping that document would go into some more detail about the structure of messages, but it didn't seem to contain any. Do you ahve any information about what shape of json I might expect to receive when I call ListMessages

For example here is one message I get:

        {
            "topic": "prod/aaa-bbb-ccc-ddd/m/d/nrf-12345678901234567890/d2c",
            "deviceId": "nrf-12345678901234567890",
            "receivedAt": "2001-01-01T01:01:01.001Z",
            "message":
            {
                "data": "29.4",
                "messageType": "DATA",
                "appId": "AIR_QUAL"
            },
            "tenantId": "aaa-bbb-ccc-ddd"
        },


And here is another:

        {
            "topic": "prod/aa-bb-cc-dd/m/d/nrf-123123123123123123/d2c",
            "deviceId": "nrf-123123123123123123123",
            "receivedAt": "2012-12-12T12:12:12.123Z",
            "message":
            {
                "data": "$GPGGA,123123.12,1231.12312,N,12312.312312,W,1,08,1.23,123.12,M,0,,*39\r\n",
                "messageType": "DATA",
                "appId": "GPS"
            },
            "tenantId": "aaa-bbb-ccc-ddd"
        },


At the moment I have to just guess at what data I might get.
Some spec or an OA document that describes it might be helpful?

[Charlie]

Hi Matt,

The Supported Schemas are listed here, and you can find a folder application-protocols/schemas/deviceToCloud at v1 · nRFCloud/application-protocols (github.com) which contains the message format and examples for different data types. 

You can also refer to sdk-nrf/json_protocol_names_nrf_cloud.h at main · nrfconnect/sdk-nrf · GitHub to understand the data types you can expect from nRF Cloud when you run the Assert Tracker V2 application.

Best regards,

Charlie

[Markus Tacker (he/him)]

The messages interpreted by nRF Cloud are documented here: github.com/.../application-protocols