Обзор API

REST API для программного доступа к данным TGIO.APP.

Базовый URL

https://back.tgio.app/api

Формат

• Request body: JSON
• Response: JSON
• Кодировка: UTF-8

Аутентификация

Для интеграций используйте API-токен — создайте его в боте (Настройки → API Токены):

curl https://back.tgio.app/api/links \
  -H "Authorization: Bearer tgio_sk_ВАШ_ТОКЕН"

Также поддерживаются JWT Bearer token и Telegram initData. Подробности: Аутентификация.

Доступ

API доступен на тарифах Starter и выше. На тарифе Free API недоступен.

Rate Limiting

Тариф	API вызовов/мес
Free	0
Starter	1 000
Pro	50 000
Business	∞

Подробности: Rate Limits.

Формат ответов

Успех:

{
  "data": { ... }
}

Ошибка:

{
  "statusCode": 403,
  "message": "Forbidden",
  "error": "..."
}

Полный список ошибок: Ошибки.

SDK

Для быстрой интеграции доступны официальные SDK:

• TypeScript / JavaScript — npm install @tgio-analytics/sdk
• PHP — composer require tgio/sdk
• Python — pip install tgio-sdk

Подробнее: SDK.