curl -X POST "https://api.scanova.io/tag/custom/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "tag": "vip" }'
{ "tag": "vip" }
المجلدات والوسوم
إنشاء وسم مخصّص
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" }
ينشئ وسمًا مخصّصًا للحساب مُقدِّم الطلب على مضيف Management API (
api.scanova.io)، مصادَقًا عليه بمفتاح Management API الخام الخاص بك.
POST https://api.scanova.io/tag/custom/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
مطلوب
اسم الوسم، حتى 50 حرفًا. يُرفض إذا احتوى على
< أو > (يمنع مثلًا حمولات <script>).curl -X POST "https://api.scanova.io/tag/custom/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "tag": "vip" }'
{ "tag": "vip" }
الوسوم مشتركة بالاسم، أما الملكية فلا
اسم الوسم الأساسي (vip) قيمة مشتركة/عامة عبر النظام بأكمله — إنشاء وسم مخصّص إما يعيد استخدام وسم موجود بهذا الاسم أو ينشئ واحدًا جديدًا. أما ما يخص كل حساب على حدة فهو سجل الملكية: يفشل هذا الاستدعاء بالرد 400 إذا كان لدى هذا الحساب بالفعل وسم مخصّص بهذا الاسم، حتى لو كان اسم الوسم نفسه مستخدَمًا في مكان آخر (مثلًا مُرفقًا برموز QR لحساب آخر).
طرق ذات صلة
- سرد الوسوم المخصّصة الخاصة بك — رؤية ما يضيفه هذا الاستدعاء.
- سرد الوسوم — دليل الوسوم الكامل للحساب.
- نظرة عامة على Management API — مخطط المصادقة وقواعد الحصة المطبّقة على هذا الطرف.
التفويضات
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.
الجسم
application/json
Tag name. Rejected if it contains < or >.
Maximum string length:
50الاستجابة
Custom tag created.
هل كانت هذه الصفحة مفيدة؟