مطورAPI مفاتيح

ما هو المطورAPI ؟

LeyAppيكشف عن واجهة برمجة تطبيقات REST عامةAPI ضمن /api/v1، يمكنك البحث عن المحامين، والاطلاع على مدى توفرهم، وبدء الحجوزات من موقعك الإلكتروني أو تطبيقك أو أداتك الداخلية. يعمل الوصول الأساسي للقراءة بدون أي بيانات اعتماد، ولكنAPI يزيد المفتاح من حدود معدل الاستخدام، ويفتح نقاط نهاية إضافية، ويمنحك لوحة تحكم تحتوي على مفاتيحك واستخدامك.

أيLeyApp يمكن إنشاء حسابAPI المفاتيح - لست بحاجة إلى نوع حساب خاص. تبدأ الحجوزات من خلالAPI لا يتم تحصيل الرسوم تلقائيًا أبدًا: يؤكد العميل دائمًا ويدفع فيleyapp.es لذا فإن عملية التكامل الخاصة بك لا تتعامل أبداً مع الأموال أو تفاصيل البطاقات.

إنشاءAPI مفتاح

تتم إدارة المفاتيح من لوحة التحكم الخاصة بك:

1. افتح لوحة التحكم → المطور من الشريط الجانبي.
2. انقر فوق "إنشاء مفتاح" وقم بإعطائه اسمًا وصفيًا، على سبيل المثال "أداة موقع الويب (الإنتاج)".
3. اختر نوع المفتاح: مباشر للطلبات الحقيقية، أو اختبار للتجربة بأمان.
4. انسخ المفتاح فوراً واحفظه في مكان آمن، مثل مدير كلمات المرور أو التخزين السري لمزود خدمة الاستضافة الخاص بك.

مفاتيح الاختبار مقابل المفاتيح الفعلية

تتصرف مفاتيح الاختبار (leyk_test_...) تمامًا مثل المفاتيح الفعلية - نفس نقاط النهاية، ونفس الاستجابات، ونفس التحقق - مع اختلاف جوهري واحد: لا يحدث أي شيء فعلي. يتم التحقق من طلب الحجز التجريبي بالكامل مقابل التوافر الفعلي، ولكن لا يتم إنشاء أي نية حجز ولا يتم إخطار أي محامٍ.

تُنشئ المفاتيح المباشرة (leyk_...) نوايا حجز حقيقية. عندما يتبع العميل رابط التأكيد الخاص بنية الحجز المباشرة، يتم نقله إلى الصفحة العادية.LeyApp عملية الدفع والتأكيد.

مفاتيح مكتب المحاماة

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

يستطيع المالكون والمسؤولون إدارة مفاتيح الشركة مباشرةً. أما باقي الأعضاء، فيبدأون بدون أي صلاحيات وصول، ويجب منحهم الصلاحيات تدريجياً من قائمة أعضاء الشركة.

• عرض - اطلع على مفاتيح الشركة، وبادئاتها، وتاريخ آخر استخدام لكل منها. ولا يُكشف السر نفسه لأي شخص مرة أخرى، بما في ذلك المالكين.
• إدارة - إنشاء مفاتيح الشركة وإلغاؤها وتعليقها وتقييدها.
• Webhooks — إدارة نقاط نهاية Webhooks الخاصة بالشركة.

تُطبَّق ضوابط إضافية على المفاتيح الثابتة. يمكنك تقييد المفتاح بقائمة من عناوين IP أو نطاقات عناوين، بحيث يُرفض حتى المفتاح المُسرَّب من أي مكان آخر. كما يمكنك تعليق المفتاح مؤقتًا دون حذفه، وهو أمر مفيد أثناء التحقيق في أمر غريب.

باستخدام مفتاحك

أرسل المفتاح في ترويسة Authorization لكل طلب: "Authorization: Bearer leyk_...". لا تزال الطلبات التي لا تحتوي على مفتاح تعمل مع نقاط النهاية العامة، ولكن بمعدلات طلبات مجهولة أقل.

تتضمن كل استجابة ترويسة X-Request-Id. إذا حدث أي خلل غير متوقع، يُرجى تضمين هذا المعرّف عند التواصل مع الدعم الفني، فهذا يُتيح لنا تحديد طلبك بدقة في ثوانٍ.

حدود المعدل

تبدأ المفاتيح الجديدة من المستوى المجاني: 60 طلبًا في الدقيقة و5000 طلبًا في اليوم. يوضح لك كل ردّ مدى تقدمك عبر ترويسة X-RateLimit-Limit وX-RateLimit-Remaining؛ إذا تجاوزت الحد، ستتلقى ردًا برمز 429 مع ترويسة Retry-After تُخبرك بموعد المحاولة مرة أخرى.

توجد مستويات أعلى للشركاء ويتم منحها من قبلLeyApp فريق العمل - تواصلوا معنا عبر نموذج الدعم إذا كانت عملية التكامل الخاصة بكم تحتاج إلى مساحة أكبر.

حفظ المفاتيح في مكان آمن

أنAPI المفتاح هو كلمة مرور خاصة بنظام التكامل الخاص بك. تعامل معه على هذا الأساس:

• لا تضع مفتاحًا في كود جانب العميل أو تطبيقات الهاتف المحمول أو المستودعات العامة - أي شخص يمكنه قراءته يمكنه إنفاق حد المعدل الخاص بك والتصرف ضمن نطاقات المفتاح.
• استخدم مفتاحًا منفصلاً لكل عملية تكامل أو بيئة، حتى تتمكن من إلغاء واحد دون تعطيل الآخرين.
• قم بإلغاء المفاتيح التي لم تعد تستخدمها. الإلغاء فوري - الطلبات التي تستخدم مفتاحًا ملغيًا تفشل في المكالمة التالية.
• إذا كان هناك احتمال لتسريب مفتاح، فقم بإلغائه فورًا من لوحة التحكم ← المطور، ثم أنشئ مفتاحًا بديلًا. عملية التناوب لا تتطلب أي توقف: أنشئ المفتاح الجديد أولًا، ثم انشره، ثم ألغِ المفتاح القديم.

استكشاف الأخطاء

أحصل على رمز الخطأ 401 "غير صالح"API مفتاح".

تأكد من أن العنوان هو بالضبط "Authorization: Bearer leyk_..." بدون أي مسافات زائدة، وأن المفتاح لم يتم إبطاله. لاحظ أن رموز MCP (ley_...) موجودة في الإعدادات ←API تُعتبر الرموز بيانات اعتماد مختلفة، وهي غير صالحة على واجهة برمجة تطبيقات REST.API .

أحصل على رسالة الخطأ 429 "تم تجاوز الحد الأقصى للسعر".

لقد تجاوزت الحد المسموح به للدقيقة أو اليوم في باقتك. التزم برسالة "إعادة المحاولة بعد" وأعد المحاولة مع تأخير متزايد. إذا تجاوزت الحد اليومي بانتظام، فاسألنا عن إمكانية الترقية إلى باقة أعلى.

لا تظهر حجوزاتي التجريبية في أي مكان.

هذا مقصود - مفاتيح الاختبار تتحقق من كل شيء ولكنها لا تُنشئ أي شيء. انتقل إلى مفتاح حقيقي لإنشاء نوايا حجز حقيقية.

لا أستطيع رفع تعليق أحد مفاتيح شركتي.

يمكن تعليق المفتاح من قبل شركتك أو من قبلLeyApp يمكن لأي مالك أو مسؤول رفع قرارات الإيقاف الصادرة عن شركتك. الإيقاف الذي تم فرضه من قبلLeyApp على سبيل المثال، أثناء قيامنا بالتحقيق في حركة المرور غير المعتادة، لا يمكن رفعها إلا من قبلنا، لذا يرجى الاتصال بـ support@leyapp.es .