Quickstart: REST (5 минут)

Первый аутентифицированный вызов API с учётом кредитов.

Цель: выполнить первый аутентифицированный вызов API со списанием кредитов.

1. Получите ключ. Выпустите со scope link:links.write — см. API-ключи. Он понадобится как bearer-токен для запроса ниже.

2. Выполните вызов.

curl -X POST https://api.link.solved.group/v1/links \
  -H "Authorization: Bearer slv_live_e17Hk2Qp…9xZr4fT2aB" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 8f1c6e2a-9b7d-4e3f-9a21-9c2b7a0f5e41" \
  -d '{
    "destination_url": "https://example.com/spring",
    "slug": "spring-sale"
  }'

Idempotency-Key обязателен, потому что вызов списывает кредиты: если соединение оборвётся и вы повторите запрос с тем же ключом, вернётся та же ссылка, а не вторая. На каждую новую ссылку — новый UUID.

3. Разберите ответ.

{
  "id": "lnk_01J9Z4A7R3V5W2XN4V6B0RTC5H",
  "short_url": "https://slv.link/spring-sale",
  "destination_url": "https://example.com/spring",
  "created_at": "2026-10-02T12:00:00Z",
  "credits_charged": 1,
  "credits_balance": 2499
}

id — канонический идентификатор ссылки для последующих GET/PATCH/DELETE. credits_charged и credits_balance — сколько стоил вызов и сколько осталось, без лишнего запроса. Если что-то пошло не так, вернётся problem+json со стабильным code — см. Концепцию ошибок.

Куда дальше:

Список и пагинация ссылок — GET /v1/links?cursor=…
Лимиты и повторы
Quickstart MCP — та же операция из AI-агента