API-ключи для разработчиков

Ключ API нужен, чтобы получать ответы SafeLaw в своём приложении. Рабочий ключ тратит деньги с кошелька аккаунта, отладочный — ничего не тратит.

Создать ключ

  1. Откройте «Настройки» → «API».
  2. В блоке «Новый ключ» введите «Название» и выберите «Режим»: «Рабочий» или «Отладочный».
  3. Нажмите «Создать».
  4. В окне «Ключ создан» нажмите «Скопировать» или «Скачать файлом» и сохраните ключ в надёжном месте.
  5. Нажмите «Готово, я сохранил». До обновления страницы ключ ещё доступен в полосе вверху: «Ключ ещё доступен для копирования — до обновления страницы.»

Режимы

РежимНачало ключаЧто тратит
Рабочийsf_live_…баланс кошелька: $2 за 1 млн входящих токенов, $4 за 1 млн исходящих, списание в сумах
Отладочныйsf_test_…ничего — отвечает по упрощённой модели, для проверки интеграции

Управлять ключами — в блоке «Мои ключи»:

  • «Скопировать» — скопировать значение ключа;
  • «Настройки» — название и «Месячный предел, токенов» («0 — без предела»). Предел защищает от скрипта, который за ночь израсходует весь баланс;
  • «Перевыпустить» — новый ключ с тем же балансом и настройками; старый перестаёт работать сразу;
  • «Отозвать» — запросы с ключом перестают работать сразу.

В блоке «Наблюдение» видны запросы, расход и ошибки за 7, 30 или 90 дней. Все рабочие ключи тратят общий баланс «Кошелёк». Чтобы пополнить кошелёк, напишите в поддержку.

Ключи организации создаёт только руководитель: «Организация» → «Настройки» → «API-ключи».

Если не работает

Что видитеЧто делать
«API пока недоступен для вашего аккаунта.»Напишите в поддержку SafeLaw.
«Рабочий ключ расходует оплаченные токены. Новый ключ создаётся с нулевым балансом — сначала купите токены.»Пополните кошелёк, затем пользуйтесь рабочим ключом. Для проверки возьмите отладочный.
«Значение этого ключа недоступно для показа — перевыпустите ключ, чтобы получить новое.»Нажмите «Перевыпустить» и замените ключ в своём приложении.
«Ключи API может создавать только руководитель.»Ключи организации создаёт руководитель.
«Ключ не найден или уже отозван.»Создайте новый ключ.
Статья помогла?

Не нашли ответ?

Напишите нам — поможем с входом, оплатой и работой сервиса. По своей правовой ситуации задайте вопрос в чате SafeLaw.