Chamadas de uso de API disponíveis:
Adicionar .xml antes de qualquer outro parâmetro de string de consulta retornará XML e .json retornará JSON.
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/
FEED_ID_HERE/message.xml
Últimas 50 mensagens em formato XML:
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/
FEED_ID_HERE/message.xml
Paginação em incrementos de 50 no formato XML (Nota: sem ?start= resulta nos 50 mais recentes por padrão):
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/
FEED_ID_HERE/message.xml?start=51
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/
FEED_ID_HERE/message.xml?start=101
Últimas 50 mensagens em formato JSON (ambas são a mesma solicitação):
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/FEED_ID_HERE/message.json
Últimas 50 mensagens com senha (você poderá adicionar ?feedPassword a qualquer uma das solicitações de feed):
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/FEED_ID_HERE/message.xml?feedPassword=123456
Start/End Date - aplica-se a restrição máxima de dados de 7 dias, independentemente da data inserida:
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/FEED_ID_HERE/message.xml?startDate=2012-07-03T00:00:00-0000&endDate=2012-08-02T00:00:00-0000
(A funcionalidade offset não está implementada no momento, usar -0000 é o único offset disponível)
Latest - Este mostrará a mensagem mais recente para cada dispositivo na página compartilhada e apenas a mensagem mais recente:
https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/FEED_ID_HERE/latest.xml
Os seguintes tipos de mensagens estão disponíveis no feed atual:
- OK (Check-In)
- TRACK (Rastreio)
- EXTREME-TRACK (Rastreio Extremo)
- UNLIMITED-TRACK (Rastreio Ilimitado)
- NEWMOVEMENT (Novo Movimento)
- HELP (Ajuda)
- HELP-CANCEL (Cancelar Ajuda)
- CUSTOM (Mensagem Customizada)
- POI
- STOP (Parar)
O XML retornado por meio de um feed api.findmespot.com terá a seguinte aparência:
<?xml version="1.0" encoding="UTF-8"?>
<response>
<feedMessageResponse>
<count>10</count>
<feed>
<id>03XHH0sPyTiYUsYD2TVJ4q7CzEH89HBhG</id>
<name>OneAtATime</name>
<description>OneAtATime</description>
<status>ACTIVE</status>
<usage>0</usage>
<daysRange>7</daysRange>
<detailedMessageShown>true</detailedMessageShown>
</feed>
<totalCount>10</totalCount>
<activityCount>0</activityCount>
<messages>
<message clientUnixTime="0">
<id>4937065</id>
<messengerId>0-8356068</messengerId>
<messengerName>Spot2</messengerName>
<unixTime>1364909292</unixTime>
<messageType>HELP-CANCEL</messageType>
<latitude>-99999.0</latitude>
<longitude>-99999.0</longitude>
<modelId>SPOT2</modelId>
<showCustomMsg>Y</showCustomMsg>
<dateTime>2013-04-02T06:28:12-0700</dateTime>
<hidden>0</hidden>
<messageContent>The help message has been cancelled</messageContent>
</message>
<message clientUnixTime="0">
<id>4937064</id>
<messengerId>0-8356068</messengerId>
<messengerName>Spot2</messengerName>
<unixTime>1364909283</unixTime>
<messageType>HELP</messageType>
<latitude>45.42249</latitude>
<longitude>-111.68832</longitude>
<modelId>SPOT2</modelId>
<showCustomMsg>Y</showCustomMsg>
<dateTime>2013-04-02T06:28:03-0700</dateTime>
<hidden>0</hidden>
<messageContent>This is the default HELP message. Please update.</messageContent>
</message>
<message clientUnixTime="0">
<id>4937060</id>
<messengerId>0-8356068</messengerId>
<messengerName>Spot2</messengerName>
<unixTime>1364908774</unixTime>
<messageType>CUSTOM</messageType>
<latitude>45.42249</latitude>
<longitude>-111.68832</longitude>
<modelId>SPOT2</modelId>
<showCustomMsg>Y</showCustomMsg>
<dateTime>2013-04-02T06:19:34-0700</dateTime>
<hidden>0</hidden>
<messageContent>This is a custom message</messageContent>
</message>
<message clientUnixTime="0">
<id>4937059</id>
<messengerId>0-8356068</messengerId>
<messengerName>Spot2</messengerName>
<unixTime>1364908765</unixTime>
<messageType>OK</messageType>
<latitude>45.42249</latitude>
<longitude>-111.68832</longitude>
<modelId>SPOT2</modelId>
<showCustomMsg>Y</showCustomMsg>
<dateTime>2013-04-02T06:19:25-0700</dateTime>
<hidden>0</hidden>
<messageContent>This is the default SPOT Check-in/OK message. Please update.</messageContent>
</message>
<message clientUnixTime="0">
<id>4937057</id>
<messengerId>0-8356068</messengerId>
<messengerName>Spot2</messengerName>
<unixTime>1364908512</unixTime>
<messageType>TRACK</messageType>
<latitude>45.42249</latitude>
<longitude>-111.68832</longitude>
<modelId>SPOT2</modelId>
<showCustomMsg>Y</showCustomMsg>
<dateTime>2013-04-02T06:15:12-0700</dateTime>
<hidden>0</hidden>
</message>
</messages>
</feedMessageResponse>
</response>
O documento XML conterá 0 ou mais mensagens. Somente os mensageiros e tipos de mensagens habilitados pelo cliente estarão disponíveis neste fluxo de dados.