Pular para o conteúdo

Obter access token

Requisição

Host: Keeta. Lembre-se: o token só dá acesso a dados de merchants que autorizaram sua aplicação.

Corpo (application/json) — varia conforme o grant_type:

CampoTipoapp_level_tokenshop_level_authorization_coderefresh_token
client_idstringobrigatórioobrigatórioobrigatório
grant_typestringapp_level_tokenshop_level_authorization_coderefresh_token
client_secretstringobrigatório——
authorization_codestring—obrigatório—
refresh_tokenstring——obrigatório

Resposta 200:

CampoTipoDescrição
access_tokenstringToken de acesso
token_typestringSempre bearer
expires_inintegerValidade em segundos
refresh_tokenstringRetornado só nos modos shop_level_authorization_code e refresh_token

Erros: 401 (credenciais inválidas), 503 (serviço indisponível/manutenção).

curl -X POST https://open.mykeeta.com/api/open/opendelivery/oauth/token \
  -H "Content-Type: application/json" \
  -H "X-App-Signature: <assinatura>" \
  -d '{"client_id":"<seu_client_id>","client_secret":"<seu_client_secret>","grant_type":"app_level_token"}'
Corpoapplication/jsonobrigatório
client_idstringobrigatório

Identificador do cliente fornecido pela Keeta.

grant_typestringobrigatório

Tipo de concessão OAuth.

Value:"app_level_token"
Discriminador
client_secretstringobrigatório

Segredo do cliente fornecido pela Keeta. Preencha este campo quando grant_type = app_level_token.

curl -i -X POST \
  https://open.mykeeta.com/api/open/opendelivery/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "string",
    "grant_type": "app_level_token",
    "client_secret": "string"
  }'

Respostas

Successful returns token request.

Corpoapplication/json
grant_typestring
Discriminador
access_tokenstringobrigatório

Código que representa o token de acesso.

token_typestringobrigatório

Tipo do token. Atualmente, o único tipo aceito é bearer.

Exemplo:"bearer"
expires_ininteger

Tempo de expiração do token, em segundos.

refresh_tokenstringobrigatório

Código que representa o refresh token.
Condição: este campo é retornado quando grant_type é shop_level_authorization_code ou refresh_token. Quando grant_type é app_level_token, a resposta não contém este campo.

Resposta
{ "access_token": "string", "token_type": "bearer", "expires_in": 0, "refresh_token": "string", "grant_type": "refresh_token" }