إنشاء مفتاح API الخاص بك في solvethree واستخدامه

1. 1.

   افتح مفاتيح API

   في لوحة التحكم، افتح مفاتيح API على المسار /api-keys ضمن مساحة العمل المقصودة.

2. 2.

   سمِّ المفتاح

   اختر «إنشاء مفتاح API». أدخل في «اسم المفتاح» اسمًا يساعدك على معرفة موضع استخدامه، ثم اختر «إنشاء مفتاح».

3. 3.

   انسخ القيمة السرية الكاملة

   ضمن «احفظ مفتاح API»، انسخ القيمة السرية وخزّنها بأمان لتطبيق الخادم لديك. فهي تُعرض مرة واحدة فقط.

4. 4.

   أغلق مربع الحوار

   لا تختر «لقد حفظت هذا المفتاح» إلا بعد تخزين القيمة السرية.

صادِق الطلبات باستخدام Authorization: Bearer متبوعًا بمفتاح مساحة العمل الكامل. لا تضعه في الشيفرة التي تعمل في المتصفح.

للمثال أدناه، اضبط SOLVETHREE_API_KEY على القيمة السرية وSOLVETHREE_PROXY على عنوان URL للوكيل في بيئة الخادم. استبدل accounts.example.com وlogin باسم المضيف والإجراء المستهدفين. يجب أن يتوفر مسبقًا للموقع المستهدف ملف تعريف نشط متاح لمساحة العمل هذه؛ فإرسال اسم مضيفه لا يُنشئ ملفًا. راجع إعداد ملف تعريف الموقع إذا لم تكن قد أعددته.

# Set SOLVETHREE_API_KEY and SOLVETHREE_PROXY in your environment first.
# Replace the hostname and action with your active site profile.
jq -n \
  --arg proxy "$SOLVETHREE_PROXY" \
  --arg requestId "login-$(date +%s)-$$" \
  '{site:"accounts.example.com", action:"login", proxy:$proxy, requestId:$requestId}' \
| curl --fail-with-body --max-time 30 \
  'https://api.solvethree.com/v1/tasks?waitMs=15000' \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @-

يُرسل هذا طلب إنشاء مهمة إلى API العامة. وهو يُنشئ عملية حل فعلية، وليس مجرد فحص للمصادقة: تُحتسب رسوم المهمة الجاهزة. ولا تعني استجابة HTTP الناجحة وحدها أن المهمة جاهزة أو أن الموقع المستهدف سيقبل حلها.

تُرجع API استجابة HTTP 401.

تحقّق من ترويسة Authorization التي يرسلها الخادم. يجب أن تحتوي على Bearer متبوعًا بالقيمة السرية الكاملة، لا باسم المفتاح أو بادئة مُظهرة. تحقّق مما إذا كان المفتاح قد أُلغي.

جرّب هذا: صحّح الترويسة أو استبدل المفتاح المُلغى وحدّث إعدادات خادمك. عالج استجابة HTTP غير الناجحة قبل محاولة قراءة بيانات المهمة.

ينجح المفتاح في المصادقة، لكن ملف تعريف الموقع المقصود غير متاح.

تأكّد من مساحة العمل التي ينتمي إليها المفتاح، وما إذا كان لديها ملف تعريف نشط للموقع المستهدف. فالمفتاح الصالح من مساحة عمل أخرى ليس بيانات اعتماد عامة.

جرّب هذا: استخدم مفتاحًا ينتمي إلى مساحة العمل التي تحتوي على ملف التعريف المقصود، أو أعدّ ملف التعريف في مساحة العمل التي تستخدمها. تغيير اسم المضيف في الطلب لن يُنشئه.

لإخفاقات الطلبات والمهام الأخرى، راجع أخطاء CAPTCHA API.