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

Используйте в приложениях надёжные эндпоинты с низкой задержкой.

PUB

Публичные сервисы

Небольшие надёжные точки без учётной записи: время, адрес, страна, курсы валют и хеши.

GET /v1/public/time
GET /v1/public/timestamp
GET /v1/public/ip
GET /v1/public/geo
GET /v1/public/fx
GET /v1/public/hash
Эндпоинты: 6
Область доступа: Общедоступный
ME

Учётная запись

Кому принадлежит токен и что он позволяет.

GET /v1/account/me
GET /v1/account/sessions
POST /v1/account/sessions/revoke
POST /v1/account/sessions/revoke-all
POST /v1/account/profile
Эндпоинты: 5
Область доступа: Bearer
DNS

DNS

Заявите домен, подтвердите контроль над ним и управляйте записями.

GET /v1/dns/zones
POST /v1/dns/zones
GET /v1/dns/zones/{zone}
POST /v1/dns/zones/{zone}/verify
DELETE /v1/dns/zones/{zone}
GET /v1/dns/zones/{zone}/records
POST /v1/dns/zones/{zone}/records
GET /v1/dns/zones/{zone}/records/{id}
PATCH /v1/dns/zones/{zone}/records/{id}
DELETE /v1/dns/zones/{zone}/records/{id}
Эндпоинты: 10
Область доступа: Bearer
KEY

Учётные данные

Приватное хранилище учётных данных за одноимённым инструментом.

GET /v1/cred
POST /v1/cred
Эндпоинты: 2
Область доступа: Bearer
FILE

Файлы

Личное хранилище: список, загрузка, изменение, доступ по ссылке и удаление.

GET /v1/files
GET /v1/files/{id}
GET /v1/files/download
POST /v1/files/upload
POST /v1/files/update
POST /v1/files/rename
POST /v1/files/delete
POST /v1/files/upload-chunk
POST /v1/files/upload-finalize
Эндпоинты: 9
Область доступа: Bearer
API

CDN

Кеширование на границе сети и трафик ваших общих файлов.

GET /v1/cdn/stats
POST /v1/cdn/config
POST /v1/cdn/purge
Эндпоинты: 3
Область доступа: Bearer
API

Пересылка SMS

Сообщения с телефона и ключи, которые их пропускают.

GET /v1/sms/messages
GET /v1/sms/keys
POST /v1/sms/keys
DELETE /v1/sms/keys
Эндпоинты: 4
Область доступа: Bearer
API

Статические сайты

Загрузите zip — получите сайт.

GET /v1/sites
POST /v1/sites/deploy
POST /v1/sites/delete
Эндпоинты: 3
Область доступа: Bearer
API

Развёртывания

Ваши развёрнутые формы, вебхуки и короткие ссылки.

GET /v1/deployments
POST /v1/deployments/toggle
POST /v1/deployments/delete
Эндпоинты: 3
Область доступа: Bearer
API

Домены

Ваш портфель доменов и их регистрационные данные.

GET /v1/domains
POST /v1/domains/whois-sync
Эндпоинты: 2
Область доступа: Bearer
PKG

Пакеты

Публикуйте релизы и получайте их версии и число загрузок.

GET /v1/packages
GET /v1/packages/{slug}
POST /v1/packages/publish
POST /v1/packages/update
POST /v1/packages/delete
Эндпоинты: 5
Область доступа: Bearer
WHO

WHOIS

Регистрационные данные домена, кешируются и используются доменными инструментами.

GET /v1/whois
Эндпоинты: 1
Область доступа: Bearer

Начало работы

Общедоступные служебные эндпоинты времени, IP-адреса и курсов валют бесплатны и не требуют аутентификации.

Для API управления DNS по адресу /v1 требуется Bearer-токен со страницы Учётная запись → Ключи API. Токен получает доступ только к подтверждённым зонам своего владельца.

Общедоступный эндпоинт

fetch('https://api.c.nf/v1/public/time')
  .then(response => response.json())
  .then(data => console.log(data.data.iso8601));

Аутентифицированный эндпоинт DNS v1

fetch('https://api.c.nf/v1/dns/zones', {
  headers: { 'Authorization': 'Bearer cnf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' }
})
  .then(r => r.json())
  .then(data => console.log(data.data.zones));

Для ИИ-агентов

Направьте агента на /v1/ai — краткую справку, которую можно вставить прямо в промпт, — или на /v1/ai?format=json, где те же точки описаны как определения инструментов. /v1/openapi.json — полный контракт OpenAPI 3.1, /llms.txt — карта для сканеров. Все четыре формируются из той же таблицы маршрутов, что и эта страница, поэтому ни один из них не опишет несуществующую точку.