Return to top
На цій сторінці

Теги та домени

Усі ендпоінти потребують автентифікації.

Теги

МетодURLДозвіл
GET/apiv2/tagstags:read
POST/apiv2/tagstags:write
GET/apiv2/tags/{id}tags:read
PATCH/apiv2/tags/{id}tags:write
DELETE/apiv2/tags/{id}tags:delete

Створіть тег із name (від 1 до 100 символів) і необов'язковими color (#RRGGBB) та icon. Назва тега, що вже існує, дає 409 conflict. PATCH приймає лише поля, які змінюються. Видалення тега прибирає його з усіх посилань.

bash
curl -X POST https://api.revolink.link/apiv2/tags \
  -H "Authorization: Bearer rvlnk_your_api_key_here" \
  -H "X-Workspace-Id: your_workspace_id" \
  -H "Content-Type: application/json" \
  -d '{ "name": "spring", "color": "#29CC97" }'

Додавайте теги до посилання через tagIds, коли створюєте чи оновлюєте його.

Домени

МетодURLДозвіл
GET/apiv2/domainsdomains:read
POST/apiv2/domainsdomains:write
GET/apiv2/domains/{id}domains:read
DELETE/apiv2/domains/{id}domains:delete

POST приймає { "domain": "go.example.com" }. Домен починає зі status: "pending". Створіть DNS-запис, описаний у полі verification відповіді, і статус стане verified. Лише після цього посилання можуть його використовувати. Якщо додати домен, який робочий простір уже має, API поверне його з кодом 200. Домен, що належить іншому робочому простору, дає 409.

bash
curl -X POST https://api.revolink.link/apiv2/domains \
  -H "Authorization: Bearer rvlnk_your_api_key_here" \
  -H "X-Workspace-Id: your_workspace_id" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "go.example.com" }'