Saltar para o conteúdo
Referência da API
/
Telefones na Nuvem
/
/Authorization

Authorization

APIs relacionadas a Authorization.

Operations

Token de acesso

Request

Troca um API ID e uma API key por um token bearer OAuth2.

  • Pré-requisitos: client_id é o API ID e client_secret é a API key. O membro precisa estar ativo, e o IP de quem chama precisa satisfazer as listas de permissão e de bloqueio de IP da Open API.
  • Efeito: nenhum; o token é autoassinado e nada é armazenado no servidor.
  • Validade: expires_in segundos, 3600 por padrão. Não existe token de atualização nem endpoint de atualização; solicite um token novo no lugar.
  • Concorrência: como os tokens não têm estado, emitir um novo não invalida os anteriores: vários podem ser válidos ao mesmo tempo. Um token deixa de funcionar apenas quando expira ou quando a API key é rotacionada.
  • Nova tentativa: é seguro repetir.

Erros de negócio documentados: 12002, 35002, 35005. Consulte Error Codes para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Headers
Content-Typestringrequired
Example:application/json
Bodyapplication/json
client_idstringrequired

Um ID de API identifica um membro.

client_secretstringrequired

Uma chave de API autentica um ID de cliente. Para chamar as APIs do MoreLogin, você precisará trocar seu ID de API e sua chave de API por um token de acesso. Mantenha esse segredo em segurança.

grant_typestringrequired

Nome do pacote — necessário apenas se appVersionId não for fornecido.

Example:"client_credentials"
curl -i -X POST \
  https://api.morelogin.com/oauth2/token \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "1661515884160372",
    "client_secret": "string",
    "grant_type": "client_credentials"
  }'

Responses

Sucesso. data é um objeto com os campos scope, access_token, token_type, expires_in e client_metadata.

Headers
any
Bodyapplication/json
codeintegerrequired
msgstring or nullrequired
dataobjectrequired
requestIdstringrequired
Response
{
  "code": 0,
  "msg": null,
  "data": {
    "scope": "cloudphone",
    "access_token": "example-access-token\n",
    "token_type": "Bearer",
    "expires_in": 3600,
    "client_metadata": { … }
  },
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e"
}