Return to top
En esta página

Etiquetas y dominios

Todos los endpoints requieren autenticación.

Etiquetas

MétodoURLPermiso
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

Crea una etiqueta con name (de 1 a 100 caracteres) y, opcionalmente, color (#RRGGBB) e icon. Un nombre de etiqueta que ya existe responde 409 conflict. PATCH acepta solo los campos que cambian. Al eliminar una etiqueta se quita de todos los enlaces.

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

Pon etiquetas en un enlace con tagIds cuando lo crees o lo actualices.

Dominios

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

POST acepta { "domain": "go.example.com" }. El dominio empieza con status: "pending". Crea el registro DNS descrito en el campo verification de la respuesta y el estado pasa a verified. Solo entonces los enlaces pueden usarlo. Si añades un dominio que el espacio de trabajo ya tiene, se devuelve con 200; un dominio que pertenece a otro espacio de trabajo 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" }'