SPOT Gen4

Mensageiro GPS Satelital

Ajuda

Documentos

Firmware

Aplicativos

ÚLTIMO FIRMWARE

Data de Lançamento
18/10/2022
Versão Firmware
2.1
Versão Atualizador do Firmware
2.9.3
Atualizar Firmware >>

Suporte SPOT Gen4

Geral

API Pública e Feed XML

Suporte API SPOT: [email protected]

Acesso à API:

Devido a abusos, as chamadas de API agora são limitadas. Se você receber uma mensagem de erro 429, será necessário diminuir suas solicitações.

Tenha parcimônia ao fazer chamadas de API, este serviço é fornecido gratuitamente, por favor não abuse dele. Acessar repetidamente o mesmo feed em períodos de tempo muito curtos resultará no bloqueio do seu IP ou na desativação do seu feed.

Aguarde pelo menos 2,5 minutos entre chamadas do mesmo feed e, se você estiver solicitando vários feeds, faça com que seu aplicativo pare pelo menos 2 segundos entre as solicitações de feed.

--A API retornará apenas dados do momento em que o feed foi criado, até um máximo de sete dias. Exemplo: se você criar um feed totalmente novo para um dispositivo hoje, não será possível extrair dados de dias anteriores nesse novo feed. --

O feed SPOT XML é construído sobre um fluxo de dados XML que é ativado quando um novo feed XML é criado.

O primeiro passo é criar um feed XML em sua conta.

Passo 1

Passo 2

Passo 3

Passo 4

Passo 5

Passo 6

Copie este ID de feed. Você precisará adicioná-lo ao URL da API para que seu URL fique assim:

https://api.findmespot.com/spot-main-web/consumer/rest-api/2.0/public/feed/0onlLopfoM4bG5jXvWRE8H0Obd0oMxMBq/message.xml

Se você precisar obter seu ID de feed novamente, clique em Exibir detalhes na guia Feed XML e ele exibirá seu ID de feed para você.

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.

PRECISA DE MAIS AJUDA?

Entre em Contato

TELEFONE

Segunda – Sexta 8h00 – 22h00 (Horàrio de Brasília)

Por favor, tenha seu PIN em mãos quando ligar.
A confirmação do PIN não funciona via voz. Digite seu PIN no teclado de discagem do telefone.
Seu PIN pode ser encontrado fazendo login em Minha Conta.

0800 879 2275