curl --request POST \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/link-qrs/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "qr_ids": ["Q07afe81aa0034c01", "Qa91d"] }'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Booth Signup",
"created": "2026-08-16T20:46:12.554000+05:30",
"is_active": true,
"usage_count": 2,
"linked_qrs": [
{ "qr_code__id": 9021, "qr_code__qrid": "Q07afe81aa0034c01", "qr_code__name": "docs-v2-first-qr-code", "qr_code__qr_type": "dy" }
],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-09-08T10:12:00.000000+05:30"
}
العملاء المحتملون والنماذج
ربط رموز QR بنموذج
POST /forms//link-qrs/
POST
/
forms
/
{form_id}
/
link-qrs
/
curl --request POST \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/link-qrs/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "qr_ids": ["Q07afe81aa0034c01", "Qa91d"] }'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Booth Signup",
"created": "2026-08-16T20:46:12.554000+05:30",
"is_active": true,
"usage_count": 2,
"linked_qrs": [
{ "qr_code__id": 9021, "qr_code__qrid": "Q07afe81aa0034c01", "qr_code__name": "docs-v2-first-qr-code", "qr_code__qr_type": "dy" }
],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-09-08T10:12:00.000000+05:30"
}
يضبط المجموعة الكاملة من رموز QR المرتبطة بنموذج.
يمكن ربط رموز QR الديناميكية فقط (
هذا الاستدعاء يستبدل مجموعة الروابط بأكملها — يُفصَل أولًا كل رمز QR مرتبط حاليًا بهذا النموذج، ثم تُربط بالضبط رموز QR التي ترسلها. للاحتفاظ برابط موجود، أدرج
qrid الخاص به في الطلب.يتطلب فقط مصادقة الحساب — على عكس معظم أطراف الكتابة في هذا المورد، لا يُطبَّق هنا تحقق من حصة
MANAGEMENT_API أو صلاحية LEAD_GENERATION_CAN_EDIT.string
مطلوب
معرّف
form_id للنموذج.array
مطلوب
مصفوفة من سلاسل
qrid — المجموعة الكاملة من رموز QR التي يجب أن يكون النموذج مرتبطًا بها بعد ذلك.curl --request POST \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/link-qrs/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "qr_ids": ["Q07afe81aa0034c01", "Qa91d"] }'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Booth Signup",
"created": "2026-08-16T20:46:12.554000+05:30",
"is_active": true,
"usage_count": 2,
"linked_qrs": [
{ "qr_code__id": 9021, "qr_code__qrid": "Q07afe81aa0034c01", "qr_code__name": "docs-v2-first-qr-code", "qr_code__qr_type": "dy" }
],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-09-08T10:12:00.000000+05:30"
}
qr_type: "dy") التي يملكها هذا الحساب — يُستبعد qrid لرمز QR ثابت أو تابع لجهة أخرى بصمت من المجموعة المستهدفة بدلاً من إثارة خطأ.
ذو صلة
- جلب نموذج — عرض مجموعة الروابط الحالية.
- إنشاء نموذج — إرفاق رمز QR وقت الإنشاء عبر
qr_id. - نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وبنية الحصص التي ينتمي إليها هذا الطرف.
التفويضات
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.
الاستجابة
200
Form with the updated link set.
هل كانت هذه الصفحة مفيدة؟