صادِق طلباتك وتحقق من المفتاح بنقطة /me
أرسل المفتاح في ترويسة كل طلب إلى مضيف مساحة العمل (Host). ابدأ بطلب GET /api/v1/me لتتأكد أن المفتاح صالح، وتعرض اسم المساحة والنطاقات.
الخطوات
1
حدد المضيف (Host): العنوان نفسه الذي تفتح منه كورتيكسا في المتصفح.
عملاء باقة Enterprise لهم نطاق فرعي (subdomain) خاص، والمفتاح لا يعمل إلا على مضيفه.
2
أرسل
GET https://{HOST}/api/v1/me مع Authorization: Bearer crtk_live_... أو X-Api-Key: crtk_live_....3
اقرأ الرد.
200 يحمل workspace_name وworkspace_id وtenant_type وscopes. اعرض «متصل بـ...».4
احفظ المضيف والمفتاح معاً، واستخدمهما في كل طلب.
5
عامل أي
401 مفاجئ على أنه فصل: احذف المفتاح المحفوظ واطلب من العميل مفتاحاً جديداً.كيف يعمل
/me لا يحتاج نطاقاً، فأي مفتاح صالح يستدعيه. استخدم scopes في الرد لتنبيه العميل إن نقص نطاق تحتاجه.
workspace_id يكون null لعملاء Enterprise (tenant_type: dedicated)، والمفتاح يعمل.
كل الردود بغلاف { message, data }، والترقيم في pagination على المستوى الأعلى.
إذا حدثت مشكلة
ما تراه
السبب
الحل
401 Missing API keyلا ترويسة.
أرسل
X-Api-Key أو Authorization.401 Invalid or expired API keyالمفتاح ملغى أو منتهٍ أو خطأ.
اطلب مفتاحاً جديداً.
401 على مضيف صحيح لمفتاح سليمالمفتاح لمساحة على مضيف آخر.
استخدم مضيف المساحة التي أُنشئ فيها المفتاح.
قواعد يجب معرفتها
120 طلباً في الدقيقة لكل مفتاح.
الطلب بلا مفتاح يرجع
401.هل حلّ هذا الدليل مشكلتك؟
إن لم يحلها، سنسألك عمّا كان ناقصاً.