Перейти к основному содержанию
Каждый запрос к API CSBoard (кроме GET /v1/health и GET /v1/public/prices) должен содержать действительный API-ключ. Ключи относятся к пространству имён csb_pub_, имеют либо доступ только на чтение, либо торговый доступ и привязаны к вашему аккаунту CSBoard. Сервер хранит только SHA-256-хеш каждого ключа — сам секрет показывается один раз при создании и больше никогда, поэтому сохраните его в надёжном месте.

​
Получение API-ключа

1

Откройте вкладку API в профиле

Перейдите на csboard.com/profile?tab=api и при необходимости войдите в аккаунт.
2

Сгенерируйте новый ключ

Нажмите Generate key. Выберите метку, отражающую назначение ключа (например, price-tracker-prod).
3

Скопируйте ключ немедленно

Ваш новый ключ csb_pub_… отображается только один раз. Скопируйте его в менеджер секретов или переменные окружения, прежде чем закрыть окно.
4

Включите торговлю (опционально)

Если вам нужно размещать ордера, найдите ключ в списке и переключите Trading enabled. Перед этим ознакомьтесь с предупреждением ниже.
Возможность торговли отделена от доступа на чтение и должна быть явно включена для каждого ключа на странице профиля. Ключ без включённой торговли вернёт 403 trading_not_enabled при попытке вызвать POST /v1/orders. Никогда не включайте торговлю на ключе, которым вы делитесь с третьими лицами или встраиваете в клиентский код.

​
Передача ключа в запросах

Отправляйте ключ как Bearer-токен в заголовке Authorization в каждом запросе:
Ключ принимается только в заголовке. Ключ в адресе (?api_key=csb_pub_...) отклоняется с 401 api_key_in_query_string: адреса попадают в логи серверов, историю браузера и заголовок Referer. Если вы когда-либо передавали ключ так, перевыпустите его в профиле.

​
Возможности ключей

Создавайте отдельные ключи для разных задач (например, один ключ для чтения — для дашборда цен, другой — торговый — для бота-покупателя), чтобы их можно было отзывать независимо, не нарушая работу всего сразу.

​
Безопасность и хранение

Мы храним только SHA256(key) — никогда сырой секрет. Это означает:
  • Если вы потеряли ключ, придётся сгенерировать новый; опции «показать ключ» нет.
  • Скомпрометированный ключ можно мгновенно отозвать из профиля без влияния на другие ключи.

​
Ошибки аутентификации

Каждая ошибка API возвращает JSON-тело такого формата:
Подробнее об ошибке 429 и о том, как корректно делать back-off, см. Лимиты запросов.