Esta referência ajuda a implementar a API do SULTS v1. Essa API usa um formato JSON para saída e é capaz de manipular solicitações CORS (Cross-Origin Resource Sharing).
A API é sem estado – todas as solicitações são validadas em um token da API. O token da API será disponibilizado pela equipe da SULTS.
Autenticação
Todas as chamadas de serviços devem ser autenticadas por um token, garantindo a segurança e confidencialidade no tráfego dos dados de cada parceiro.
O método de autenticação da API é o Basic Auth, que é um método de controle de acessos a recursos Web realizado em cima do protocolo HTTP.
O API KEY (token) consiste apenas em um único valor que deve ser enviado em um cabeçalho HTTP “Authorization” que será disponibilizado pela SULTS.
Formatação de datas
Todas os campos de datas na API de Expansão são padronizados nos seguintes formatos:
- Data e Hora: yyyy-MM-ddTHH:mm:ssZ
Todas as datas e horas são apresentados no formato UTC ISO 8601.
Máscaras
Informações que possuem máscaras (formatações de dígitos) como CNPJ, telefone, CEP, etc. São retornados sem máscaras, por exemplo:
- Celular: 11987654321
- CEP: 38026000