Документация

Быстрый старт

За 12 минут вы получите работающий CDN перед своим сайтом. Прежде всего создайте аккаунт и проверьте, что у вас есть доступ к управлению DNS для домена.

Шаг 1. Добавьте домен в панели

Зайдите в app.3tp.ru/sites/new, укажите ваш origin (например, origin.example.ru) и поддомен, который хотите ускорить (например, www.example.ru).

Шаг 2. Замените CNAME

В DNS‑зоне вашего регистратора замените текущую запись на:

www.example.ru.    CNAME    edge.3tp.ru.

В течение 5–15 минут трафик начнёт идти через edge‑узлы 3TP Cachly. Сертификат Let’s Encrypt выпустится автоматически. В панели появится статус «Активен».

Шаг 3. Проверьте, что всё работает

Откройте сайт. В заголовках ответа вы должны увидеть x-cache: HIT или MISS, а также имя edge‑узла:

$ curl -I https://www.example.ru
HTTP/2 200
server: cachly
x-cache: HIT
x-cache-node: MOW-3
age: 142

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

Все запросы к API авторизуются через bearer‑токен. Создайте токен в разделе «API» панели управления.

curl https://api.3tp.ru/v1/sites \
  -H "Authorization: Bearer $CACHLY_TOKEN"

Токен можно ограничить по областям (read, cache.purge, billing) и по конкретным проектам. Срок действия — от 1 часа до бессрочного.

Инвалидация кэша

Самый частый сценарий после деплоя — инвалидировать связанные ключи. Делается одним POST:

POST /v1/cache/purge
Content-Type: application/json

{
  "tags": ["release-2026.05", "homepage"],
  "urls": ["/api/v2/products?cat=42"],
  "notify": "tg://release-bot"
}

В ответе вы получаете количество затронутых ключей и оценочное время полной пропагации по всем узлам — обычно 300–500 мс.

CLI

Удобно использовать в CI:

$ npm i -g @cachly/cli
$ cachly login
$ cachly purge --tag release-v9 --notify tg
queued: 8421 urls, eta 380ms

$ cachly logs --filter status=503 --tail
[12:14:22] /api/checkout 503 origin=api-srv-3 traceId=8a2e
[12:14:25] /api/checkout 503 origin=api-srv-3 traceId=ab21

Node.js SDK

import { Cachly } from '@cachly/sdk';

const c = new Cachly({ token: process.env.CACHLY_TOKEN });

await c.cache.purge({ tags: ['catalog'] });
const metrics = await c.metrics.daily({ from: '2026-05-01', to: '2026-05-13' });

Python SDK

from cachly import Client

c = Client(token=os.environ["CACHLY_TOKEN"])
c.cache.purge(tags=["catalog"])
metrics = c.metrics.daily(from_="2026-05-01", to="2026-05-13")