رموز QR - GetQR Docs

GetQR API في مرحلة تجريبية (beta) ومتاحة لمساحات عمل مختارة. قد تتغير التفاصيل قبل الإصدار العام.

رمز QR في GetQR هو الصورة مع رابط قصير يعمل من خلاله. إنشاء رمز QR يُنشئ رابطه القصير أيضًا، فيمكنك تغيير الوجهة لاحقًا دون إعادة طباعة الرمز.

الطريقة	المسار	الوصف
`GET`	`/api/v1/qrs`	عرض قائمة رموز QR
`POST`	`/api/v1/qrs`	إنشاء رمز QR
`GET`	`/api/v1/qrs/{qrId}`	الحصول على رمز QR
`PATCH`	`/api/v1/qrs/{qrId}`	تحديث رمز QR
`PUT`	`/api/v1/qrs/{qrId}`	ضبط حالة الإيقاف المؤقت
`POST`	`/api/v1/qrs/{qrId}/pause`	إيقاف رمز QR مؤقتًا
`POST`	`/api/v1/qrs/{qrId}/activate`	إعادة تفعيل رمز QR
`POST`	`/api/v1/qrs/{qrId}/duplicate`	تكرار رمز QR
`DELETE`	`/api/v1/qrs/{qrId}`	حذف رمز QR
`GET`	`/api/v1/qrs/{qrId}/download`	تنزيل صورة رمز QR

بيانات رمز QR حسب النوع

صيغة data لكل نوع من الأنواع الستة عشر.

التخصيص

أنماط النقاط والألوان والإطارات والشعارات.

قواعد الوصول

الجدول الزمني وحد المسح وكلمة المرور.

لإحصائيات المسح الخاصة برمز QR، راجع التحليلات.

كائن رمز QR

تُرجع كل نقطة نهاية لرموز QR هذا الكائن، باستثناء الحذف والتنزيل. وتُرجع القائمة مصفوفة منها.

string

المعرّف الفريد لرمز QR، مثل qr_1EPcVfeHZAY2iNoVLsgW2Aqf.

string

نوع رمز QR، مثل website. راجع بيانات رمز QR حسب النوع للاطلاع على القيم الست عشرة كلها.

string | null

اسم رمز QR، المعروض في لوحة التحكم.

string | null

ملاحظة نصية حرة عن رمز QR.

string

الحمولة المحفوظة. في wifi وvcard وsocial وmultilink وevent وsms هي الحمولة التي أرسلتها. وفي كل الأنواع الأخرى هي الرابط القصير، لذا اقرأ الوجهة من url.

boolean

true عندما يكون رمز QR موقوفًا مؤقتًا.

boolean

true لرمز QR ثابت أُنشئ في لوحة التحكم ولا رابط قصيرًا له. تُنشئ API دائمًا رموز QR ديناميكية.

string | null

الرابط القصير الكامل، مثل https://getqr.sh/x7Kd2p1.

string | null

نطاق الرابط القصير.

string | null

المعرّف النصي (slug) للرابط القصير.

boolean

true عندما يكون المعرّف النصي قد اختير بدلًا من توليده.

string | null

الوجهة التي يعيد الرابط القصير التوجيه إليها.

string | null

الوجهة لزوار iOS، في رموز QR من نوع app.

string | null

الوجهة لزوار Android، في رموز QR من نوع app.

integer

إجمالي عدد عمليات المسح.

object

قواعد الوصول. لا تُرجع كلمة المرور نفسها أبدًا. راجع قواعد الوصول.

إظهار properties

boolean

ما إذا كان على الزوار إدخال كلمة مرور.

string | null

البداية المجدولة، بصيغة ISO 8601.

string | null

النهاية المجدولة، بصيغة ISO 8601.

integer | null

الحد الأقصى لعدد عمليات المسح.

string

للقراءة فقط. custom تصميم يمكن لـ API تعديله بالكامل. branded وai تصميم بعلامة تجارية أو تصميم بالذكاء الاصطناعي أُنشئ في لوحة التحكم. لا تستطيع API تعديل صورته، لكنها تحتفظ بها عند تغيير الحقول الأخرى.

object

التصميم المحفوظ: styles وframeOptions وlogoOptions، وكل منها كائن أو null. لها البنية نفسها لحقول الطلب، فيمكنك إرسالها مرة أخرى. راجع التخصيص.

object | null

ملف رمز QR من نوع pdf أو image أو video: id وname وsize بالبايت.

string | null

للقراءة فقط. الاسم المعروض لرمز QR من نوع app أُنشئ في لوحة التحكم.

object | null

للقراءة فقط. رمز QR من نوع pdf يضم عدة ملفات، أُنشئ في لوحة التحكم: title وlayout وfiles.

object | null

للقراءة فقط. رمز QR من نوع image يضم عدة صور، أُنشئ في لوحة التحكم: title وlayout وfiles.

string

تاريخ الإنشاء، بصيغة ISO 8601.

string

تاريخ آخر تحديث، بصيغة ISO 8601.

لا تُرجع البيانات السرية والمعرّفات الداخلية (password، userId، workspaceId، projectId) أبدًا.

{
  "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
  "qrType": "website",
  "title": "Landing page",
  "description": null,
  "data": "https://getqr.sh/x7Kd2p1",
  "archived": false,
  "isStatic": false,
  "shortLink": "https://getqr.sh/x7Kd2p1",
  "domain": "getqr.sh",
  "key": "x7Kd2p1",
  "keyIsCustom": false,
  "url": "https://example.com",
  "ios": null,
  "android": null,
  "scans": 128,
  "access": {
    "passwordProtected": false,
    "activeAt": null,
    "pauseAt": null,
    "scanLimit": null
  },
  "designKind": "custom",
  "design": {
    "styles": { "dotsOptions": { "type": "rounded", "color": "#1E40AF" }, … },
    "frameOptions": { "id": "card", "text": "Scan me!", … },
    "logoOptions": { "type": "suggested", "id": "logo-website-3", "scalePercent": 25 }
  },
  "file": null,
  "appName": null,
  "pdfBundle": null,
  "imageGallery": null,
  "createdAt": "2026-08-01T10:00:00.000Z",
  "updatedAt": "2026-08-01T10:00:00.000Z"
}

عرض قائمة رموز QR

GET /api/v1/qrs يُرجع رموز QR في مساحة عملك، صفحة تلو الأخرى.

integer

افتراضي:"1"

الصفحة التي تُعاد، 1 أو أكثر.

integer

افتراضي:"100"

رموز QR في كل صفحة، من 1 إلى 100. تُرفض القيمة الأكبر.

string

يطابق عنوان رمز QR. الاستعلامات التي تزيد على حرفين تطابق أيضًا data المحفوظة. في أنواع الروابط تكون data المحفوظة هي الرابط القصير، لذا لا يمكن البحث في روابط الوجهة.

string

افتراضي:"createdAt"

حقل الترتيب: createdAt أو updatedAt أو clicks (إجمالي عمليات المسح) أو lastClicked (أحدث عملية مسح) أو type. يرتّب type دائمًا تنازليًا ويتجاهل sortOrder.

string

افتراضي:"desc"

اتجاه الترتيب: asc أو desc.

boolean

افتراضي:"false"

تضمين رموز QR الموقوفة مؤقتًا.

boolean

افتراضي:"false"

إرجاع رموز QR الموقوفة مؤقتًا فقط. يتجاوز showArchived.

تأخذ المعاملات المنطقية السلسلتين true أو false. اطلب الصفحة التالية ما دام pagination.hasMore يساوي true. راجع ترقيم الصفحات.

curl "https://getqr.com/api/v1/qrs?page=1&pageSize=100" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "data": [
    {
      "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
      "qrType": "website",
      "title": "Landing page",
      "shortLink": "https://getqr.sh/x7Kd2p1",
      "url": "https://example.com",
      "scans": 128,
      "…": "…"
    }
  ],
  "pagination": { "page": 1, "pageSize": 100, "total": 1, "hasMore": false }
}

إنشاء رمز QR

POST /api/v1/qrs يُنشئ رمز QR ورابطه القصير معًا. يُرجع 201 Created مع رمز QR الجديد.

string

رمز إعادة المحاولة الخاص بك. تكرار الطلب بالمفتاح نفسه خلال 24 ساعة يُرجع الاستجابة الأصلية بدلًا من إنشاء رمز QR ثانٍ. راجع إعادة المحاولة والتكرار.

string

مطلوب

ما يرمّزه رمز QR. يحدد أيضًا الصيغة التي يجب أن تكون عليها data. إحدى القيم: website، pdf، image، video، whatsapp، social، wifi، app، feedback، vcard، sms، payment، location، multilink، email، event.

string

مطلوب

حمولة النوع، ويُتحقق منها وفق qrType. السلسلة الفارغة تتخطى الفحص. صيغة كل نوع موجودة في بيانات رمز QR حسب النوع.

object

الرابط القصير الذي يعمل رمز QR من خلاله. اختياري: إذا حُذف، يتبع link.url قيمة data.

إظهار properties

string

الوجهة التي يعيد الرابط القصير التوجيه إليها. إذا حُذف أو كان فارغًا، تكون قيمته الافتراضية data. إذا أُرسلا كلاهما واختلفا، تكون الأولوية لـ link.url. تشير رموز QR من الأنواع vcard وsocial وmultilink وevent دائمًا إلى صفحتها المستضافة، وتشير رموز pdf وimage وvideo التي تحتوي على fileId إلى الملف. المخططات المقبولة: http:، https:، wifi:، mailto:، sms:، begin:.

string

نطاق الرابط القصير. يجب أن يكون نطاقًا مفعّلًا في مساحة عملك: النطاق الآخر يحصل على 403، والنطاق غير المفعّل بعد يحصل على 422. القيمة الافتراضية النطاق الافتراضي لمساحة العمل.

string

المعرّف النصي للرابط القصير، من 3 إلى 15 حرفًا، ويُحفظ بأحرف صغيرة. المعرّف غير المسموح يحصل على 422، والمعرّف المستخدم يحصل على 409. يُولَّد معرّف عشوائي من 7 أحرف عند حذفه.

string | null

رابط الوجهة لزوار iOS، في رموز QR من نوع app.

string | null

رابط الوجهة لزوار Android، في رموز QR من نوع app.

string | null

عنوان معاينة الرابط (og:title)، يُحفظ على الرابط القصير. يختلف عن title الخاص برمز QR نفسه. لا يعرضه شيء بعد.

string | null

وصف معاينة الرابط (og:description)، يُحفظ على الرابط القصير. لا يعرضه شيء بعد.

—

غير متاحين في هذه الواجهة: إرسال أي منهما يحصل على 422. استخدم access.pauseAt لإيقاف رمز QR في وقت محدد.

string

اسم رمز QR، المعروض في لوحة التحكم. تُزال المسافات من طرفيه، من 1 إلى 40 حرفًا. إذا حُذف، يكون رمز QR بلا عنوان.

string

ملاحظة نصية حرة عن رمز QR. حتى 280 حرفًا.

string

ملف رمز QR من نوع pdf أو image أو video، مرفوع بالغرض المطابق. وفي vcard وsocial وmultilink، صورة ملف شخصي اختيارية مرفوعة بالغرض logo. يقبله event أيضًا، لكن صفحته تقرأ صورة الغلاف من data.fileId. تحصل الأنواع الأخرى على 422. ارفع الملف أولًا عبر الملفات. راجع الملفات في رموز QR.

string

القالب الذي يُطبَّق تصميمه على رمز QR الجديد. تُدمج حقول التصميم التي ترسلها فوقه. القالب ذو التصميم بعلامة تجارية أو بالذكاء الاصطناعي يحصل على 422 (art_template_unsupported). القالب غير المعروف، أو القالب من مساحة عمل أخرى، يحصل على 404.

object

أشكال النقاط والزوايا وألوانها. راجع التخصيص.

object

الإطار المرسوم حول رمز QR ونص الدعوة إلى الإجراء. راجع التخصيص.

object

الشعار في الوسط: شعار مقترح أو ملفك الخاص المرفوع بالغرض logo. يُرفض الملف غير المعروف، أو الرفع غير المكتمل، أو الملف من غرض آخر. راجع التخصيص.

object

الجدول الزمني وحد المسح وحماية كلمة المرور. راجع قواعد الوصول.

إظهار properties

string | null

البداية المجدولة، بصيغة ISO 8601.

string | null

النهاية المجدولة، بصيغة ISO 8601.

integer | null

الحد الأقصى لعدد عمليات المسح، عدد صحيح موجب.

string | null

كلمة المرور التي يجب على الزوار إدخالها. إرسالها يفعّل الحماية.

boolean

يوقف الحماية أو يعيد تفعيلها، مع الاحتفاظ بكلمة المرور المحفوظة.

boolean

ما إذا كان رمز QR موقوفًا مؤقتًا. true تُنشئه موقوفًا مؤقتًا: تعرض عمليات المسح صفحة الإيقاف المؤقت بدلًا من الوجهة.

تُحذف الحقول غير المعروفة دون خطأ. راجع غير مدعوم عبر API.

curl -X POST "https://getqr.com/api/v1/qrs" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: landing-page-2026-08" \
  -d '{
    "qrType": "website",
    "data": "https://example.com",
    "title": "Landing page",
    "access": { "scanLimit": 500 }
  }'

{
  "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
  "qrType": "website",
  "title": "Landing page",
  "data": "https://getqr.sh/x7Kd2p1",
  "shortLink": "https://getqr.sh/x7Kd2p1",
  "url": "https://example.com",
  "scans": 0,
  "access": { "passwordProtected": false, "activeAt": null, "pauseAt": null, "scanLimit": 500 },
  "…": "…"
}

إعادة المحاولة والتكرار

مع مفتاح. مع الترويسة Idempotency-Key، تُعاد الاستجابة نفسها لمدة 24 ساعة.
دون مفتاح. يُعامَل الجسم المطابق المُرسَل خلال 30 ثانية على أنه مكرر.
الإعادات. تُرجع الإعادة الاستجابة المحفوظة مع x-idempotent-replay: true. ويُرجع رمز QR الجديد false.
قيد التنفيذ. الطلب الثاني أثناء تنفيذ الأول يحصل على 409 conflict.
الإخفاقات. الإنشاء الفاشل يحرّر المفتاح فورًا، فيمكنك إعادة المحاولة بالمفتاح نفسه.
أفضل جهد. إذا لم تكن آلية الحماية متاحة، تُنفَّذ عمليات الإنشاء دون حماية.

راجع أيضًا عدم التكرار (Idempotency).

الحصول على رمز QR

GET /api/v1/qrs/{qrId} يُرجع رمز QR مع رابطه القصير وقواعد الوصول والتصميم، وملفه في الأنواع المعتمدة على الملفات.

string

مطلوب

معرّف رمز QR، من استجابة القائمة أو الإنشاء.

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf" \
  -H "Authorization: Bearer $GETQR_API_KEY"

الاستجابة هي كائن رمز QR الكامل.

تحديث رمز QR

PATCH /api/v1/qrs/{qrId} يغيّر محتوى رمز QR أو وجهته أو تصميمه أو قواعد الوصول الخاصة به. أرسل فقط الحقول التي تريد تغييرها. يُرجع رمز QR المحدَّث.

string

مطلوب

معرّف رمز QR.

يأخذ الجسم الحقول نفسها التي يأخذها إنشاء رمز QR، وكلها اختيارية، مع هذه الاختلافات:

templateId. غير مقبول.
link. جزئي. تُحفظ الوجهة الحالية عند حذف link.url. يحصل link.domain وlink.key على 422: الرابط القصير هو ما يرمّزه الرمز المطبوع، لذا أنشئ رمز QR جديدًا لاستخدام رابط مختلف.
data. يُتحقق منها وفق النوع الناتج فقط عند تغيّر data أو qrType. يُرفض تبديل qrType دون data مطابقة. راجع تبديل النوع.
التصميم. تُدمج styles وframeOptions وlogoOptions في التصميم المحفوظ، لذا لا يغيّر الكائن الجزئي إلا ما يذكره. اختيار شعار آخر يستبدله لكنه يحتفظ بحجمه.
access. يُطبَّق كل مفتاح عند وجوده. null تمسح قاعدة. تنتمي قواعد الوصول إلى access: إرسالها ضمن link يحصل على 422.
archived. يوقف رمز QR ورابطه القصير مؤقتًا أو يعيد تفعيلهما معًا، مثل الإيقاف المؤقت وإعادة التفعيل.

curl -X PATCH "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Autumn campaign",
    "access": { "password": "s3cr3t", "passwordProtected": true }
  }'

{
  "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
  "title": "Autumn campaign",
  "access": { "passwordProtected": true, "activeAt": null, "pauseAt": null, "scanLimit": null },
  "…": "…"
}

ما يتيح لك كل نوع تغييره بعد الطباعة مذكور في بيانات رمز QR حسب النوع.

ضبط حالة الإيقاف المؤقت

PUT /api/v1/qrs/{qrId} يضبط حالة الإيقاف المؤقت مباشرة. يؤدي الإيقاف المؤقت وإعادة التفعيل المهمة نفسها بصورة أوضح.

string

مطلوب

معرّف رمز QR.

boolean

مطلوب

true لإيقاف رمز QR مؤقتًا، وfalse لإعادة تفعيله.

curl -X PUT "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "archived": true }'

{
  "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
  "archived": true,
  "…": "…"
}

إيقاف رمز QR مؤقتًا

POST /api/v1/qrs/{qrId}/pause يمنع رمز QR من التوجيه إلى وجهته: تعرض عمليات المسح صفحة الإيقاف المؤقت بدلًا من ذلك. يظل الرمز المطبوع ورابطه القصير صالحين. لا يوجد جسم طلب.

string

مطلوب

معرّف رمز QR.

curl -X POST "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/pause" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
  "archived": true,
  "…": "…"
}

إعادة تفعيل رمز QR

POST /api/v1/qrs/{qrId}/activate يجعل رمز QR الموقوف مؤقتًا يوجّه إلى وجهته مرة أخرى. يظل أي جدول زمني أو حد مسح ساريًا. لا يوجد جسم طلب.

string

مطلوب

معرّف رمز QR.

curl -X POST "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/activate" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf",
  "archived": false,
  "…": "…"
}

تكرار رمز QR

POST /api/v1/qrs/{qrId}/duplicate يُنشئ نسخة بالمحتوى والتصميم نفسيهما. لا يوجد جسم طلب. يُرجع 201 Created مع رمز QR الجديد.

string

مطلوب

معرّف رمز QR المراد نسخه.

الرابط القصير. تحصل النسخة على رابط قصير خاص بها، بمعرّف نصي عشوائي على النطاق الافتراضي لمساحة العمل، لا على نطاق المصدر. تُحتسب عمليات مسحها بشكل منفصل.
العنوان. يُضاف إلى العنوان اللاحقة (Copy). تبقى النتيجة ضمن 40 حرفًا: يُختصر العنوان الطويل أولًا. يبقى رمز QR الذي بلا عنوان بلا عنوان.
ما لا يُنسخ. قواعد الوصول (كلمة المرور، الجدول الزمني، حد المسح) وحالة الإيقاف المؤقت. تكون النسخة نشطة دائمًا.
الملفات. تُنسخ ملفات PDF والصور، بما فيها ملفات الحزم والمعارض، فتصبح النسخة مالكة لها. أما ملفات الفيديو وملفات التصميم، مثل الشعارات، فتُشارك مع المصدر.

curl -X POST "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/duplicate" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{
  "id": "qr_7Hk2PqWmX9cTnV4sLbR8YdZe",
  "title": "Landing page (Copy)",
  "shortLink": "https://getqr.sh/p2Wq9dL",
  "url": "https://example.com",
  "archived": false,
  "scans": 0,
  "…": "…"
}

حذف رمز QR

DELETE /api/v1/qrs/{qrId} يحذف رمز QR ورابطه القصير. يُرجع المعرّف المحذوف.

الحذف نهائي. يتوقف الرمز المطبوع ورابطه القصير عن العمل، ولا يعود سجل المسح متاحًا. أوقف رمز QR مؤقتًا بدلًا من ذلك إذا كنت قد تحتاج إليه مجددًا.

string

مطلوب

معرّف رمز QR.

string

معرّف رمز QR المحذوف.

boolean

دائمًا true.

curl -X DELETE "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf" \
  -H "Authorization: Bearer $GETQR_API_KEY"

{ "id": "qr_1EPcVfeHZAY2iNoVLsgW2Aqf", "deleted": true }

تنزيل صورة رمز QR

GET /api/v1/qrs/{qrId}/download يرسم رمز QR بتصميمه ويُرجع الملف.

string

مطلوب

معرّف رمز QR المراد رسمه، من استجابة القائمة أو الإنشاء.

string

افتراضي:"jpg"

صيغة الإخراج: jpg أو png أو svg أو pdf (صفحة A4) أو eps. يُنزَّل التصميم بعلامة تجارية أو بالذكاء الاصطناعي بصيغة jpg أو png أو pdf فقط.

integer

افتراضي:"1024"

حجم الصورة بالبكسل: 1024 أو 2048 أو 4096. يتجاهله svg وpdf. يُنزَّل التصميم بعلامة تجارية أو بالذكاء الاصطناعي بحجم 1024 فقط.

`format`	`Content-Type`	اسم الملف
`jpg`	`image/jpeg`	`<title>-<resolution>px.jpg`
`png`	`image/png`	`<title>-<resolution>px.png`
`svg`	`image/svg+xml`	`<title>.svg`
`pdf`	`application/pdf`	`<title>.pdf`
`eps`	`application/postscript`	`<title>-<resolution>px.eps`

الجسم. جسم الاستجابة هو الملف نفسه. اسم الملف المقترح موجود في الترويسة Content-Disposition، ويُبنى من العنوان، أو qr-code لرمز QR بلا عنوان.
التخزين المؤقت. تحمل الاستجابات ETag وCache-Control: private, max-age=3600, must-revalidate. أرسل ETag مرة أخرى في If-None-Match للحصول على 304 Not Modified عندما لا يتغير رمز QR.
الأخطاء. الصيغة أو الدقة غير المدعومة تحصل على 400 bad_request. تذكر رسالة الخطأ السبب: qr_download_invalid_format أو qr_download_invalid_resolution أو qr_download_art_format_unsupported أو qr_download_art_resolution_unsupported.

curl "https://getqr.com/api/v1/qrs/qr_1EPcVfeHZAY2iNoVLsgW2Aqf/download?format=png&resolution=1024" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  --output qr-code.png

HTTP/1.1 200 OK
Content-Type: image/png
Content-Disposition: attachment; filename="landing-page-1024px.png"
ETag: "9f2c0e1b5a7d43c8b016e2f4a9d5c3718be40f92"
Cache-Control: private, max-age=3600, must-revalidate

<binary image data>

قواعد الوصول

أرسل كائن access عند الإنشاء أو التحديث لجدولة بداية ونهاية، أو تحديد عدد عمليات المسح، أو طلب كلمة مرور. تبقى القواعد المحذوفة دون تغيير، وnull تمسح قاعدة. السلوك الكامل، مع أمثلة، موجود في قواعد الوصول.

كائنات التصميم

تحدد styles وframeOptions وlogoOptions أشكال النقاط والزوايا، والألوان، والإطار، والشعار. تعمل بالطريقة نفسها مع رموز QR والقوالب والإنشاء المجمّع. تُرفض الأشكال أو الإطارات أو الشعارات غير المعروفة. جميع القيم المقبولة ومثال تطبيقي موجودة في التخصيص.

المشكلات الشائعة

الخطأ 422 عند ضبط كلمة مرور أو جدول زمني أو حد مسح

أرسل القاعدة ضمن access، لا ضمن link.

الخطأ 422 عند تغيير link.domain أو link.key

لا يمكن تغيير الرابط القصير بعد الإنشاء، لأن الرمز المطبوع يرمّزه. أنشئ رمز QR جديدًا بدلًا من ذلك.

422 "Expected … for qrType"

data لا تطابق صيغة qrType. تحقّق من النوع في بيانات رمز QR حسب النوع.

الخطأ 409 conflict عند إنشاء رمز QR

عملية إنشاء مطابقة لا تزال قيد التنفيذ، أو أن link.key مستخدم. أعد المحاولة بعد انتهاء الطلب الأول. مع Idempotency-Key، تُرجع إعادة المحاولة رمز QR الأصلي.

الملف المُنزَّل بصيغة JPEG لا PNG

المعاملان هما format وresolution، والقيمة الافتراضية لـ format هي jpg. أرسل format=png.

الخطأ 404 لرمز QR أراه في لوحة التحكم

يُنفَّذ كل طلب في مساحة العمل الخاصة بمفتاح API. تحقّق من أن رمز QR ينتمي إليها. راجع المصادقة.

بيانات رمز QR حسب النوع

التخصيص

قواعد الوصول

​كائن رمز QR

​عرض قائمة رموز QR

​إنشاء رمز QR

​إعادة المحاولة والتكرار

​الحصول على رمز QR

​تحديث رمز QR

​ضبط حالة الإيقاف المؤقت

​إيقاف رمز QR مؤقتًا

​إعادة تفعيل رمز QR

​تكرار رمز QR

​حذف رمز QR

​تنزيل صورة رمز QR

​قواعد الوصول

​كائنات التصميم

​المشكلات الشائعة

​الخطوات التالية

بيانات رمز QR حسب النوع

التخصيص

قواعد الوصول

التحليلات

كائن رمز QR

عرض قائمة رموز QR

إنشاء رمز QR

إعادة المحاولة والتكرار

الحصول على رمز QR

تحديث رمز QR

ضبط حالة الإيقاف المؤقت

إيقاف رمز QR مؤقتًا

إعادة تفعيل رمز QR

تكرار رمز QR

حذف رمز QR

تنزيل صورة رمز QR

قواعد الوصول

كائنات التصميم

المشكلات الشائعة

الخطوات التالية