Перейти к содержимому
Справочник API
/
Облачные телефоны
/
/Authorization

Authorization

API для раздела «Authorization».

Operations

Токен доступа

Request

Обменивает API ID и API-ключ на bearer-токен OAuth2.

  • Предварительные условия: client_id — это API ID, а client_secret — API-ключ. Участник должен быть активен, а IP вызывающего должен пройти списки разрешённых и запрещённых IP для Open API.
  • Эффект: отсутствует — токен самоподписанный, на сервере ничего не сохраняется.
  • Срок действия: expires_in секунд, по умолчанию 3600. Ни refresh-токена, ни эндпоинта обновления нет; вместо этого запросите новый токен.
  • Параллелизм: поскольку токены не имеют состояния, выпуск нового не аннулирует предыдущие — одновременно могут быть действительны несколько. Токен перестаёт работать только по истечении срока или при ротации API-ключа.
  • Повтор: безопасен.

Задокументированные бизнес-ошибки: 12002, 35002, 35005. Значения кодов см. в Error Codes. Любая операция может дополнительно вернуть общие коды.

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

Идентификатор API (API ID) идентифицирует участника.

client_secretstringrequired

Ключ API используется для аутентификации идентификатора клиента. Для вызова API MoreLogin вам потребуется обменять свой идентификатор API и ключ API на токен доступа. Храните этот секрет в безопасности.

grant_typestringrequired

Название пакета — требуется только в том случае, если не указан appVersionId.

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

Успех. data — объект с полями scope, access_token, token_type, expires_in и 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"
}