curl -X POST "https://api.scanova.io/tag/custom/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "tag": "vip" }'
{ "tag": "vip" }
Carpetas y etiquetas
Crear una etiqueta personalizada
POST /tag/custom/
POST
/
tag
/
custom
/
curl -X POST "https://api.scanova.io/tag/custom/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "tag": "vip" }'
{ "tag": "vip" }
Crea una etiqueta personalizada para la cuenta solicitante en el host de la API de gestión (
api.scanova.io), autenticado con tu clave sin procesar de la API de gestión.
POST https://api.scanova.io/tag/custom/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
requerido
Nombre de la etiqueta, hasta 50 caracteres. Se rechaza si contiene
< o > (bloquea, por ejemplo, cargas <script>).curl -X POST "https://api.scanova.io/tag/custom/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "tag": "vip" }'
{ "tag": "vip" }
Las etiquetas se comparten por nombre, la propiedad no
El nombre de etiqueta subyacente (vip) es un valor compartido/global en todo el sistema — crear una etiqueta personalizada reutiliza una etiqueta existente con ese nombre o crea una nueva. Lo que es por cuenta es el registro de propiedad: esta llamada falla con 400 si esta cuenta ya tiene una etiqueta personalizada con ese nombre, incluso si el nombre de la etiqueta ya se usa en otro lugar (por ejemplo, adjunta a códigos QR de otra cuenta).
Relacionado
- Listar tus etiquetas personalizadas — ver lo que añade esta llamada.
- Listar etiquetas — el directorio completo de etiquetas de la cuenta.
- Resumen de la API de gestión — el esquema de autenticación y las reglas de cuota que aplican a este endpoint.
Autorizaciones
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Cuerpo
application/json
Tag name. Rejected if it contains < or >.
Maximum string length:
50Respuesta
Custom tag created.
¿Esta página le ayudó?