Introdução

Com essa API é possível integrar-se, independente do canal que está chamando (Web, mobile, URA, etc.).
Os endereços e credenciais devem ser solicitados para o departamento de Implantação da Tempo Assist.

Autenticação

A autenticação das APIs é realizada com a informação de um par de tokens no cabeçalho (header) das requisições. O seguinte par de tokens é esperado em cada requisição:

client_id: Identificação da APP. Sua geração ocorre no momento da criação da APP pelo painel do desenvolvedor. Seu valor pode ser visualizado na coluna Token da lista de APPs e poderá ser utilizado tanto em Sandbox quanto em Produção após a aplicação passar pelo processo de homologação.

access_token: Identificação do token de acesso, que armazena as regras de acesso permitidas à APP. Sua geração ocorre em dois momentos no processo de integração com as APIs.


Exemplo de chamada para se autenticar no Gateway usando as credenciais

curl --location --request POST 'http://api.tempoassist.com.br/sandbox/oauth2/access-token' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic MWFkNjc5ZjctMzVlNC0zM2QxLWFjMDEtZTU0YjZhNDBjNDYyOjM0NDY3MDE1LTlhZTgtMzdmZi05MmFlLWExYjU2OWMqZDQ4Mg==' \
--data-raw '{
"grant_type": "client_credentials"
}'

Ex de response

{
"access_token": "961c45dd-ab55-3f27-adfd-ef331b8ae6ec",
"token_type": "access_token",
"expires_in": 86400
}

Para as chamadas dos endpoints incluir no header da requisição o client_id e access_token

Para abertura de assistência, utilize a API gestaoassistencia

Utilize o seguinte fluxo
Abertura Assistência

Status Codes

Código Erro Descrição
200 OK

Sucesso.
400 Bad Request

A requisição possui parametro(s) inválido(s).
401 Unauthorized

O token de acesso não foi informado ou não possui acesso as APIs.
404 Not Found

O recurso informado no request não foi encontrado.
413 Request is to Large

A requisição está ultrapassando o limite permitido para o perfil do seu token de acesso.
422 Unprocessable Entity

A requisição possui erros de negócio.
429 Too Many Requests

O consumidor estourou o limite de requisições por tempo.
500 Internal Server Error

Erro não esperado, algo está quebrado na API.
Português, Brasil