Obtenção de Token OAuth

Este endpoint permite obter um token de acesso JWT para autenticação nas APIs OpenDelivery.

Endpoint

POST /opendelivery/oauth/token

Requisição

Headers

Content-Type: application/x-www-form-urlencoded

Body

O corpo da requisição deve ser enviado no formato application/x-www-form-urlencoded com os seguintes campos:

client_id=123456&client_secret=seu_client_secret&grant_type=client_credentials

Parâmetro	Tipo	Obrigatório	Descrição
client_id	string	Sim	Identificador do cliente (string numérica) fornecido pela Goomer
client_secret	string	Sim	Chave secreta do cliente fornecida pela Goomer
grant_type	string	Sim	Tipo de concessão, sempre client_credentials

Resposta

Status: 200 OK

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer",
  "expires_in": 604800
}

Campo	Tipo	Descrição
access_token	string	Token JWT para autenticação
token_type	string	Tipo do token (sempre bearer)
expires_in	number	Tempo de vida do token em segundos (7 dias = 604800)

Possíveis Códigos de Erro

Código	Descrição
400	Requisição inválida (parâmetros ausentes ou inválidos)
401	Credenciais inválidas
429	Limite de requisições excedido

Utilização do Token

Após obter o token, utilize-o em todas as requisições subsequentes incluindo-o no header de autorização:

Authorization: Bearer {access_token}

Limites de Uso

Este endpoint possui um limite de 10 requisições por hora. Para evitar atingir este limite, recomendamos:

1. Armazenar o token em cache
2. Utilizar o token até sua expiração (7 dias)
3. Implementar renovação automática antes da expiração

Documentação Completa

Para informações detalhadas sobre parâmetros, payload e exemplos adicionais, consulte a documentação técnica completa.