authorize

Данный метод предназначен для совершения авторизации в СКО.

Входные данные: Pin

Возвращаемые данные:

• null в случае успеха.
• ошибка AVQFR_BAD_KEY_AUTH_DATA в случае, если указан неверный PIN-код.
• ошибка TIN_CODE_LEN в случае, если длина PIN-кода неверна.

Важно: после каждой неверной попытки авторизации задержка ответа увеличивается. После 3 попытки время ожидания ответа авторизации составляет 10 секунд. После ввода успешного PIN-кода задержка сбрасывается.

Примеры

Успех

Запрос:

{
  "type": "send",
  "address": "ik.service.token.authority",
  "reply_address": "example",
  "data": {
    "pin": "16522"
  },
  "headers": {
    "tokens.refresh": "true",
    "token": "AVQ11031010703",
    "action": "authorize",
    "sid": "47dc1757-3b51-4bae-b300-6acd71799426"
  }
}

Ответ:

{
  "type": "send",
  "address": "example",
  "reply_address": null,
  "data": null,
  "headers": null
}

Ошибка: Неверный PIN (неверная длина)

Запрос:

{
  "type": "send",
  "address": "ik.service.token.authority",
  "reply_address": null,
  "data": {
    "pin": "1652"
  },
  "headers": {
    "action": "authorize",
    "token": "AVQ11031010703",
    "tokens.refresh": "true",
    "sid": "47dc1757-3b51-4bae-b300-6acd71799426"
  }
}

Ответ:

{
  "type": "error",
  "address": null,
  "reply_address": null,
  "data": {
    "description": "invalid code length. current: 4, required: 5",
    "name": "TIN_CODE_LEN"
  },
  "headers": null
}

Ошибка: неверный PIN

Запрос:

{
  "type": "send",
  "address": "ik.service.token.authority",
  "reply_address": null,
  "data": {
    "pin": "16523"
  },
  "headers": {
    "token": "AVQ11031010703",
    "tokens.refresh": "true",
    "action": "authorize",
    "sid": "47dc1757-3b51-4bae-b300-6acd71799426"
  }
}

Ответ:

{
  "type": "error",
  "address": null,
  "reply_address": null,
  "data": {
    "description": "неверные данные для авторизации сессии (неверное значение PIN, PUK или REG)",
    "name": "AVQFR_BAD_KEY_AUTH_DATA"
  },
  "headers": null
}