curl -X POST "https://api.scanova.io/tag/custom/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "tag": "vip" }'
{ "tag": "vip" }
Ordner & Tags
Einen benutzerdefinierten Tag erstellen
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" }
Erstellt einen benutzerdefinierten Tag für das anfragende Konto auf dem Management-API-Host (
api.scanova.io), authentifiziert mit Ihrem rohen Management-API-Schlüssel.
POST https://api.scanova.io/tag/custom/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
erforderlich
Tag-Name, bis zu 50 Zeichen. Wird abgelehnt, wenn er
< oder > enthält (verhindert z. B. <script>-Payloads).curl -X POST "https://api.scanova.io/tag/custom/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "tag": "vip" }'
{ "tag": "vip" }
Tags werden nach Namen geteilt, Eigentümerschaft nicht
Der zugrunde liegende Tag-Name (vip) ist systemweit ein gemeinsam genutzter/globaler Wert — das Erstellen eines benutzerdefinierten Tags verwendet entweder einen bestehenden Tag mit diesem Namen erneut oder erstellt einen neuen. Pro Konto ist der Eigentümerschaftsdatensatz: Dieser Aufruf schlägt mit 400 fehl, wenn dieses Konto bereits einen benutzerdefinierten Tag mit diesem Namen hat, selbst wenn der Tag-Name selbst bereits anderswo verwendet wird (z. B. an QR-Codes eines anderen Kontos angehängt).
Siehe auch
- Ihre benutzerdefinierten Tags auflisten — sehen Sie, was dieser Aufruf hinzufügt.
- Tags auflisten — das vollständige Tag-Verzeichnis des Kontos.
- Management-API-Übersicht — das Auth-Schema und die Quota-Regeln, die für diesen Endpunkt gelten.
Autorisierungen
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.
Body
application/json
Tag name. Rejected if it contains < or >.
Maximum string length:
50Antwort
Custom tag created.
War diese Seite hilfreich?