ابدأ من هنا
البداية السريعة
نفّذ طلباً واحداً واقرأ الرد.
المصادقة
أنشئ مفتاح API الذي يستخدمه ذلك الطلب.
واجهة GraphQL
ابحث عن استعلام أو تعديل أو نوع.
Webhooks
استقبل طلب HTTP عندما يتغيّر شيء في الحساب.
MCP
دع Cursor أو Claude أو ChatGPT يستدعي الواجهة نيابةً عنك.
MiniApps
انشر تطبيقاً تثبّته حسابات أخرى.
أيها يناسبك
استدعِ GraphQL عندما يحتاج خادمك البيانات الآن. استخدم webhook عندما تريد أن يخبرك كرزون أن شيئاً تغيّر. استخدم MCP عندما يستدعي تطبيق ذكاء اصطناعي الواجهة. استخدم Dashboard SDK عندما تدمج لوحة داخل الوارد. استخدم MiniApps عندما تشحن موصّلاً يثبّته الآخرون.طلب
data. الرد الفاشل فيه مصفوفة errors. انظر الأخطاء.
قبل النشر
- أبقِ مفتاح API على خادمك. لا تضعه في JavaScript للمتصفح ولا في مستودع عام.
- تحقق من
X-Karzoun-Signature-256على كل webhook قبل أن تثق بالمحتوى. انظر Webhooks. - امنح المفتاح النطاقات التي تحتاجها تلك المهمة فقط، مثل
contacts:read. - ألغِ المفتاح من المطوّر ← مفاتيح API عندما يغادر صاحبه أو يتوقف التكامل.