Gamma Names API

Авторизация

Authorization: Bearer gn_live_xxx

API-ключ выпускается в личном кабинете: /app/api-keys. Free-аккаунты не могут выпускать или использовать API-ключи.

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

{
  "ok": true,
  "data": {}
}

{
  "ok": false,
  "error": { "code": "bad_request", "message": "..." }
}

Методы

POST /v1/domains.list

Список подключённых Cloudflare-доменов аккаунта.

curl -X POST https://api.gamma-names.ru/v1/domains.list \
  -H 'Authorization: Bearer gn_live_xxx'

POST /v1/routes.check

Проверить, доступен ли поддомен.

{ "subdomain": "demo", "base_domain": "example.com" }

POST /v1/routes.reserve

Зарезервировать parked route.

{ "subdomain": "demo", "base_domain": "example.com", "title": "Demo" }

POST /v1/routes.upsert

Создать или обновить route и привязать Gamma URL. Режимы: proxy, redirect, reserved, force_proxy, iframe.

{
  "subdomain": "demo",
  "base_domain": "example.com",
  "target_url": "https://presentation.gamma.site/",
  "mode": "proxy",
  "title": "Demo"
}

POST /v1/routes.list

Список routes аккаунта.

POST /v1/routes.delete

Удалить route по route_id или по паре subdomain + base_domain.

{ "subdomain": "demo", "base_domain": "example.com" }

Правила поддомена

Один DNS-label: латиница, цифры, дефис. Нельзя точку, подчёркивание, начальный/конечный дефис. Зарезервированы: www, mail, api, admin, console, ftp, autodiscover, autoconfig, webmail, cpanel, whm.