O MyScanner é um portal de suporte ao cliente baseado na nuvem, criado com o objetivo de permitir que os clientes acessem seus dados de digitalização e seus scanners de forma segura, em tempo real, de qualquer lugar e a qualquer hora.

A API do MyScanner faz parte da categoria Representational State Transfer (REST). Ela permite que você execute operações “RESTful”, como ler dados digitalizados do seu scanner com segurança.

A API do MyScanner usa JSON simples em HTTP1 e usa os seguintes verbos HTTP:

Atualmente, o número de chamadas à API por hora é ilimitado. A LoadScan se reserva o direito de alterar isso a qualquer momento sem notificação.

As APIs podem ser removidas ou modificadas a qualquer momento sem aviso prévio, mas nos esforçaremos para manter a funcionalidade existente sempre que possível.

As alterações que não interrompem uma API, como a adição de um novo atributo, podem ser feitas a qualquer momento. As alterações que quebram uma API de nível de produção, como a remoção de atributos ou grandes mudanças no comportamento da API, só serão feitas com um aviso prévio de 60 dias. No entanto, pode haver raras ocasiões em que, por motivos legais, de desempenho ou de segurança, sejamos forçados a fazer alterações que quebrem a API sem aviso prévio.

A autenticação na API do MyScanner é restrita de acordo com a conta do usuário e o scanner, por meio do uso de tokens de API. Os tokens de API estão vinculados à sua conta de usuário do MyScanner e à lista de scanners aos quais você tem acesso.

Os tokens de API são cadeias de 64 bytes (com 64 caracteres) e utilizam o código de autenticação de mensagem com hash chaveado (HMAC), que usa o algoritmo de hash seguro SHA-256, uma função unidirecional que não pode ser descriptografada nem revertida.

A conexão com a API do MyScanner é feita por HTTPS.

Você pode usar seu token de API para autenticar a solicitação; não é preciso digitar senha.

Por exemplo, se o seu token de API for:
5ayHUgjsa952dY37PsSkydM023OiDbgsGuS2KEydBFY9i1xJOoLeHUnuOb0Bs9dQ
E o número de série do seu scanner é:
111111
Então, um exemplo de URL é:
https://myscannerapi.loadscan.com/api.php?sid=111111&token=5ayHUgjsa952dY37PsSkydM023OiDbgsGuS2KEydBFY9i1xJOoLeHUnuOb0Bs9dQ

1. Faça login no MyScanner
2. Clique no nome da sua conta no canto superior direito.
3. Quando o menu suspenso for exibido, clique em “Profile” (Perfil).
4. Clique na guia “API Token”.
5. Clique em “Generate API Token” (Gerar token de API).
6. Quando a caixa de diálogo de confirmação for exibida, clique em “Generate API Token” (Gerar token de API) mais uma vez.
7. Seu token de API será gerado.

Todas as informações relacionadas ao scanner que você inseriu na sua chamada à API podem ser recuperadas. Isso significa que todos os registros de escaneamento já gravados pelo MyScanner podem ser recuperados.

Sua capacidade de acessar dados depende das permissões disponíveis para o usuário do MyScanner.

Campos em branco:

Os campos em branco são incluídos como nulos ou “” em vez de serem omitidos.

Campos DateTime:

Todos os registros de data e hora são retornados no formato ISO 8601 AAAA-MM-DD HH:MM:SS (Exemplo: 2016-12-25 13:30:00)

Todas as solicitações exigem a definição de, no mínimo, dois parâmetros GET.

1. O número de série1 do scanner para o qual você deseja recuperar dados
2. Seu token da API do MyScanner2

URL da solicitação:

https://myscannerapi.loadscan.com/api.php?sid=111111&token=5ayHUgjsa952dY37PsSkydM023OiDbgsGuS2KEydBFY9i1xJOoLeHUnuOb0Bs9dQ

Resposta de amostra

[
,
… …
]

Resposta de amostra

[
,
]

Resposta de amostra

[
,

]