Для доступа к Deps API вам потребуется API-ключ. Все запросы к API должны включать действительный API-ключ в заголовке X-API-Key.

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

1

Шаг 1: Запрос на создание

Перейдите в телеграм-бот и отправьте команду /new.
2

Шаг 2: Сохранение ключа

Бот сгенерирует и пришлет вам уникальный ключ. Скопируйте его и сохраните в надежном месте.

​
Использование API-ключа

Каждый запрос к Deps API должен включать ваш ключ в заголовке X-API-Key.
Example Request
curl -X GET "https://api.depscian.tech/v2/player/find?nickname=Nicolas_Reed&serverId=5" \
  -H "X-API-Key: YOUR_API_KEY"
При отсутствии или недействительности ключа API вернет ошибку 401 Unauthorized.
Error Response
{
  "error_code": "UNAUTHORIZED",
  "error_message": "API key is missing or invalid. You can get one here: https://t.me/DepsAPI_bot",
  "error_id": "401e8400-e29b-41d4-a716-446655440000"
}

​
Управление ключами

​
Просмотр и удаление

В телеграм-боте по команде /list вы можете видеть все ваши активные ключи. Если вы подозреваете, что ключ скомпрометирован, его можно немедленно удалить через меню бота. После удаления ключ становится недействительным.

​
Безопасность

Безопасное хранение

Никогда не храните API-ключи в публичных репозиториях. Используйте защищенные хранилища секретов или переменные окружения.

Ротация ключей

Регулярно меняйте API-ключи. Создайте новый ключ, обновите приложение и только потом отзовите старый.

Защищенная передача

Передавайте API-ключи только по защищенным каналам (HTTPS). Избегайте открытых сетей.

​
Пример безопасного использования (Python)

Example Private Usage
import os
import requests

# Ключ загружается из переменных окружения
api_key = os.getenv("DEPS_API_KEY")

if not api_key:
  raise ValueError("Переменная окружения 'DEPS_API_KEY' не настроена.")

def make_api_request(endpoint, params=None):
    base_url = "https://api.depscian.tech/v2"
    headers = {'X-API-Key': api_key}
    
    try:
        response = requests.get(f"{base_url}/{endpoint}", headers=headers, params=params, timeout=10)
        response.raise_for_status() 
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"Ошибка API запроса: {e}")
        return None
.env
DEPS_API_KEY=your_api_key_here

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

Код ошибкиHTTP-статусОписание
UNAUTHORIZED401Отсутствует, недействителен или заблокирован API-ключ.
RATE_LIMIT_EXCEEDED429Превышен лимит запросов для вашего ключа.

​
Частые вопросы