SELECIONE SUA REGIÃO E IDIOMA

UNITED STATES
English
CANADA
English
Français
LATIN AMERICA
Español
Português
EUROPE
English
Français
Español
Deutsch (DE)
Deutsch (AT)
Italiano
AFRICA
English
MIDDLE EAST
English
AUSTRALIA &
NEW ZEALAND
English
JAPAN
Japanese
ASIA PACIFIC
English


CERRAR
Minha Conta

Minha Conta

Get Help
Ajuda
Central de Suporte > Minha Conta > Geral > API Pública e Feed XML

Suporte Minha Conta

Ajuda

Suporte Minha Conta

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

Step 1
 

 

 

Passo 2

Step 2
 
 

Passo 3

Step 3
 
 

Passo 4

Step 4

 
 

Passo 5

Step 5

 
 

Passo 6

Step 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

Suporte por telefone está disponível de segunda a sexta, das 8h00 às 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 e clicando em Configurações e Faturamento.

0800 879 2276

Ligando de outro país?​
1 (985) 327-7511
ASSINE NOSSA NEWSLETTER
EMPRESA OU AGÊNCIA GOVERNAMENTAL?