Return to top
Nesta página

Tags e domínios

Todos os endpoints exigem autenticação.

Tags

MétodoURLPermissão
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

Crie uma tag com name (de 1 a 100 caracteres) e, opcionalmente, color (#RRGGBB) e icon. Um nome de tag que já existe responde 409 conflict. PATCH aceita apenas os campos que mudam. Excluir uma tag a remove de todos os links.

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" }'

Coloque tags em um link com tagIds ao criá-lo ou atualizá-lo.

Domínios

MétodoURLPermissão
GET/apiv2/domainsdomains:read
POST/apiv2/domainsdomains:write
GET/apiv2/domains/{id}domains:read
DELETE/apiv2/domains/{id}domains:delete

POST aceita { "domain": "go.example.com" }. O domínio começa com status: "pending". Crie o registro DNS descrito no campo verification da resposta e o status passa a verified. Só então os links podem usá-lo. Adicionar um domínio que o espaço de trabalho já tem o retorna com 200; um domínio que pertence a outro espaço de trabalho responde 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" }'