باختصار
- الـ API العام موجود على
https://web.kringl.ai/api/v1ويتحدث JSON. النقاط والمعاملات والأخطاء في صفحة مرجع الـ API (بالإنجليزية). - يُنشأ المفتاح في البوابة، في شاشة مفاتيح API في حسابكم. يظهر مرة واحدة فقط ويخص عضوًا واحدًا في الفريق.
- ما يفعله أعضاء Kringl عبر الـ API هو بالضبط ما يفعلونه في المحادثة: المحادثة نفسها، الرصيد نفسه، وطلب الدمج نفسه.
ما الموجود هنا
Kringl هو فريق من أعضاء Kringl، شخصيات لكل منها اسم ودور، تقوم بعمل البرمجيات: مارك يكتب الكود، بابلو يصمّم، وستيف ينشر في متاجر التطبيقات. في معظم الوقت تعملون معهم في المحادثة، في التطبيق على web.kringl.ai.
هذا التوثيق للحظة التي لا تكفي فيها المحادثة: نظام خاص بكم يجب أن يفتح محادثة بنفسه، ويرسل رسالة إلى محادثة قائمة، ويتابع تشغيلًا ويُبلَّغ عند انتهائه. لكل هذا API واحد، ومستند واحد يصفه.
- مرجع الـ API (بالإنجليزية): المفاتيح والصلاحيات، الأعراف، حدود الطلبات، الجلسات والتشغيلات، webhooks، ومثال كامل من البداية إلى النهاية.
- الأتمتة: كيف تولد المهمة من نموذج أو بريد إلكتروني أو واتساب أو لوحة TODO، بلا كود إطلاقًا.
- السوق: الخدمات التي يربطها Kringl بالمواقع والتطبيقات.
البداية
- سجّلوا الدخول إلى البوابة على web.kringl.ai بمستخدمكم.
- في شاشة مفاتيح API اضغطوا على مفتاح جديد، سمّوه وانسخوه. يظهر مرة واحدة فقط.
- أرسلوا أول طلب:
GET /api/v1/meمع المفتاح في ترويسةAuthorization: Bearer. الرد يقول من أنتم وفي أي استوديو. - تابعوا إلى الجلسات والتشغيلات.
curl https://web.kringl.ai/api/v1/me \
-H "Authorization: Bearer wzk_your_key_here"
المفتاح هو كلمة مرور. احفظوه في خزنة أو في بيئة الخادم الخاص بكم، وليس في الكود، وليس في commit، وليس في متصفح المستخدم.
أين يوجد كل شيء
| ماذا | أين |
|---|---|
| التطبيق | web.kringl.ai |
| الـ API | https://web.kringl.ai/api/v1 |
| مفاتيح API | web.kringl.ai/account/apikeys |
| التوثيق | kringl.ai/docs |
| الشروط والخصوصية | شروط الاستخدام (بالإنجليزية), سياسة الخصوصية (بالإنجليزية) |
ينقصكم شيء في التوثيق؟ اكتبوا لنا بالبريد الإلكتروني، بالعبرية أو بالإنجليزية، ويردّ عليكم شخص من الفريق.