للذكاء الاصطناعي

كل ما يحتاجه مساعد البرمجة الذكي لبناء تكامل مع CrispHive — موجّه جاهز للّصق، وموارد قابلة للقراءة آليًا، وأهم حقائق واجهة البرمجة في مكان واحد.

التثبيت بالذكاء الاصطناعي

الصق هذا الموجّه في مساعد البرمجة الذكي الخاص بك لبدء التكامل:

Read the CrispHive backend integration skill at
https://api.crisphive.com/developers/SKILL.md and the OpenAPI spec at
https://api.crisphive.com/developers/openapi.json.

Then implement a client for my backend that:
1. Authenticates with an API key as a Bearer token (chsk_test_… for sandbox)
2. Creates a customer and a job request
3. Keeps job requests in sync by polling GET /v1/job-requests/changes
   with the next_since cursor

موارد قابلة للقراءة آليًا

يُقدَّم كلا الملفين من واجهة البرمجة نفسها، لذا يطابقان دائمًا النسخة المنشورة — وجِّه مساعدك إلى هذين الرابطين مباشرة بدلًا من نسخ صفحات التوثيق إلى سياقه.

حقائق أساسية لمساعدك

• عنوان URL الأساسي هو https://api.crisphive.com/v1 — تتشارك بيئتا sandbox وlive المسارات نفسها؛ وتُحدَّد البيئة عبر بادئة المفتاح (chsk_test_… مقابل chsk_live_…).
• صادِق على كل طلب عبر Authorization: Bearer <api key>. المفاتيح لا تنتهي صلاحيتها وتمنح وصولًا كاملًا — احتفظ بها في الخادم.
• قيمة error_code تساوي 0 تعني النجاح؛ وأي قيمة أخرى خطأ، وتُدرج أخطاء التحقق تفاصيل كل حقل في errors.
• انسخ البيانات عبر استدعاء GET /v1/job-requests/changes بمؤشر next_since المُعاد بدلًا من إعادة سرد الموارد.
• لا تزال Webhooks في مرحلة المعاينة — اعتمد حاليًا على تدفق التغييرات للمزامنة الموثوقة.

نصائح لنتائج أفضل

• اجعل المساعد يقرأ SKILL.md أولًا — فهو صغير بما يكفي ليتّسع في السياق ويجيب عن معظم أسئلة التكامل دون المواصفة الكاملة.
• ولِّد أنواع الطلب/الاستجابة من openapi.json بدلًا من ترك النموذج يخمّن أسماء الحقول.
• طوِّر باستخدام مفتاح sandbox (chsk_test_…) ولا تنتقل إلى live إلا بعد نجاح التدفقات من البداية إلى النهاية.
• عند تصحيح الأخطاء، تحقّق من error_code — لا من حالة HTTP وحدها.