API: Токены

Эндпоинты для управления API-токенами. Токены позволяют получать программный доступ к API с ограниченными правами (scopes).

Доступные scopes

GET /api/tokens/scopes

Ответ:

{
  "scopes": ["*", "read:links", "write:links", "read:stats", "read:channels", "read:pixels", "write:pixels"]
}

Список токенов

GET /api/tokens

Ответ:

[
  {
    "id": 1,
    "name": "CI/CD Token",
    "token_prefix": "tgio_a1b2...",
    "scopes": ["read:links", "read:stats"],
    "is_active": true,
    "expires_at": "2026-01-01T00:00:00Z",
    "last_used_at": "2025-01-15T10:00:00Z",
    "last_used_ip": "1.2.3.4",
    "usage_count": 42,
    "revoked_at": null,
    "created_at": "2025-01-01T00:00:00Z"
  }
]

WARNING

Полный токен отображается только при создании. Сохраните его сразу — повторно получить невозможно.

Создать токен

POST /api/tokens

Body:

{
  "name": "CI/CD Token",
  "scopes": ["read:links", "read:stats"],
  "expires_at": "2026-01-01T00:00:00Z"
}

scopes и expires_at опциональны. По умолчанию scope * (полный доступ).

Ответ:

{
  "token": "tgio_a1b2c3d4e5f6...",
  "id": 1,
  "name": "CI/CD Token",
  "token_prefix": "tgio_a1b2...",
  "scopes": ["read:links", "read:stats"],
  "expires_at": "2026-01-01T00:00:00Z",
  "created_at": "2025-01-15T10:00:00Z"
}

Удалить (отозвать) токен

DELETE /api/tokens/:id

Ответ:

{ "success": true }

Для всех эндпоинтов используйте заголовок Authorization: Bearer <token>.