الرابط الأساسي https://api.echonova.ai

المطورون

قراءة سجل الطلبات

افتح تبويب سجل الطلبات، واقرأ معنى كل عمود، واعثر على الاستدعاء الذي أرسله نظامك، واعرف الطلبات التي لا تُسجَّل أبدًا.

يُسجَّل كل طلب على API المطورين يعثر فيه إيكونوڤا على مفتاحه، وتعرض البوابة أحدث الطلبات ضمن المطورون في تبويب سجل الطلبات. استخدمه لتتأكد أن استدعاءً وصل إلى إيكونوڤا، ولترى الحالة التي أُجيب بها، ولتعرف أي مفتاح أرسله. وللإجماليات والرسوم البيانية والفلاتر، استخدم النشاط.

ما تحتاجه

  • حساب في إيكونوڤا ومساحة عمل بها مفتاح API واحد على الأقل. راجع احصل على مفتاح API.
  • صلاحية مالك مساحة العمل، وتشمل الإذن developer_api.view.
  • طلب واحد على الأقل أُرسل بمفتاح. حتى ذلك الحين يعرض التبويب لا توجد طلبات بعد.

الخطوات

الخطوة 1: افتح تبويب سجل الطلبات

انتقل إلى /developers?tab=request-log، أو افتح المطورون في البوابة واختر تبويب سجل الطلبات. يحمّل التبويب أحدث 50 طلبًا، الأحدث أولًا.

الخطوة 2: اقرأ الأعمدة

كل صف يمثل طلبًا واحدًا. لا يعرض التبويب عناوين أعمدة؛ يعرض الصف هذه الحقول من اليسار إلى اليمين:

الحقل ما يعرضه
الرمز رمز HTTP الذي تلقاه عميلك، مثل 200 أو 400 أو 503. يُسجَّل الطلب الناجح بالرمز 200.
الأسلوب POST أو GET أو DELETE.
الطلب المسار، مثل /v1/text-to-speech/sync. لا يُسجَّل نص الاستعلام.
المستخدم الاسم لمفتاح API الذي أرسل الطلب.
الطابع الزمني وقت تسجيل الطلب، بالمنطقة الزمنية لمتصفحك، مثل Sep 15, 2026, 10:21:04 AM.

الخطوة 3: ابحث عن الاستدعاء الذي تبحث عنه

الصفوف مرتبة من الأحدث إلى الأقدم، دون فلتر. استخدم وظيفة البحث في متصفحك داخل الصفحة. يُسجَّل كل طلب، لذا يحصل كل استطلاع للمهمة بطلب GET على صفه. ويحصل POST الذي أنشأ المهمة على صف أيضًا، ويُسجَّل بالرمز 200 إذا نجح.

تحمل كل استجابة من API header X-Request-Id. سجّله عندك، وابحث عن القيمة نفسها كـ معرّف الطلب في تبويب السجلات في النشاط، حيث يعرض كل صف أيضًا الخدمة والصوت والرصيد والوحدات المحتسبة، وفي حالة الفشل رسالة الخطأ.

للعثور على استدعاء واحد، الصق قيمة X-Request-Id الخاصة به في ابحث بمعرّف الطلب في تبويب السجلات. يعرض لك ذلك الاستدعاء من آخر 365 يومًا، مهما كانت الفترة والتصفيات. امسح الحقل لتعود إلى القائمة.

طابق السجل مع سجلاتك بواسطة معرّف الطلب. يعرض السجل المسار والحالة والمفتاح؛ وكل شيء آخر عن الاستدعاء موجود في سجلاتك أنت.

الموصى به

  • يسجّل خادمك كل طلب مع اسم المفتاح وX-Request-Id الذي استلمه، وتبحث عن معرّف الطلب هذا في تبويب السجلات في النشاط.

الأقل فاعلية

  • لا يسجّل خادمك شيئًا، وتفحص أحدث 50 صفًا حسب الطابع الزمني بعد حادثة ما.

ماذا يحدث بعد ذلك

  • يُحمَّل التبويب مرة واحدة عند فتحه. أعد تحميل الصفحة لترى الطلبات التي أُرسلت بعدها.
  • يُسجَّل الطلب بعد أن تجيب عليه الواجهة، أيًا كانت حالته: يحصل كل من 200 و400 على صف، وكذلك 403. ولا يحصل على صف إلا أول 429 خاص بالمفتاح في كل نافذة للحد، أما ما يليه في النافذة نفسها فلا. يحتفظ الصف بالحالة التي تلقاها عميلك. وتبقى المهمة غير المتزامنة المقبولة على 200 حتى لو فشلت لاحقًا.
  • تُسجَّل طلبات GET وDELETE أيضًا، مثل استطلاع المهمة أو عرض الأصوات. ولا تخصم أي رصيد.
  • يحتوي السجل على صفوف API فقط. لا تحصل عمليات تشغيل البوابة واستخدام الوكلاء على صفوف، وتظهر أرصدتها في سجل الرصيد.
  • حذف مفتاح لا يحذف صفوفه، ويستمر حقل المستخدم في عرض اسم المفتاح.
  • تُحذف الصفوف بعد 365 يومًا من الطلب.

الحدود

الحد القيمة ينطبق على
الصفوف المعروضة 50، الأحدث أولًا تبويب سجل الطلبات
الفلاتر والترقيم والتصدير لا يوجد؛ استخدم النشاط لذلك تبويب سجل الطلبات
المسجَّل لكل طلب الأسلوب، والمسار، ورمز الحالة، وزمن الاستجابة، والمفتاح، والطابع الزمني، ومعرّف الطلب، والخدمة، والصوت، والوحدات المحتسبة، ورسالة الخطأ كل صف
غير المسجَّل متن الطلب، والـ headers، ونص الاستعلام، ومتن الاستجابة، وعنوان IP للعميل كل صف
الطلبات المسجَّلة الطلبات بأي أسلوب التي عثر فيها على مفتاح API نقاط نهاية /v1
الاحتفاظ 365 يومًا من الطلب كل الصفوف

استكشاف الأخطاء وإصلاحها

لا توجد طلبات بعد

لم يجتز أي طلب أُرسل بمفتاح من مساحة العمل هذه المصادقة. أرسل طلبًا واحدًا، مثل POST /v1/text-to-speech/sync بمفتاح صالح، ثم أعد تحميل التبويب.

طلب أرسله عميلي غير مدرج

قد يغيب الطلب إذا رُفض قبل أن تعرف إيكونوڤا المفتاح. يُجاب بالرمز 401 (header مفقود أو مشوّه، أو مفتاح غير معروف أو معطّل أو محذوف، أو مساحة عمل مغلقة) وبالرمز 429 لكل عنوان IP قبل ذلك، فلا يحصل أي منهما على صف. وكذلك الجسم الأكبر من 100 كيلوبايت (413) أو الذي ليس JSON صالحًا (400)، فهو يُرفض قبل فحص المفتاح ولا يحصل على صف. والأمر نفسه لمسار غير معروف (404 Route not found) ولطريقة خاطئة على مسار موجود (405 Method not allowed)، لأن المفتاح لا يُفحص. أما 403 و429 الخاص بالمفتاح فيأتيان بعد العثور على المفتاح. يُسجَّل 403 دائمًا، ولا يُسجَّل إلا أول 429 خاص بالمفتاح في كل نافذة للحد.

الصف يعرض 200 لمهمة فاشلة، أو 201 لطلب POST

قبلت API المهمة وأجابت بـ 200، لذا يحتفظ الصف بالرمز 200. وعندما تفشل المهمة لاحقًا يُعاد رصيدها، لكن الصف لا يتغير.

قد تظهر الصفوف الأقدم بالرمز 201 لطلب POST ناجح حتى تنتهي بعد 365 يومًا. ويعرض كل صف آخر الرمز 200 للنجاح.

تظهر «غير معروف» في عمود المستخدم

لم يُعثر على المفتاح. المفتاح الذي حذفته من البوابة ما زال يعرض اسمه؛ ولا يظهر غير معروف إلا عندما لا يوجد المفتاح على الإطلاق.

الأسئلة الشائعة

هل يعرض السجل الطلبات المرسلة بمفتاح خاطئ أو معطّل؟

لا. يُرفض الطلب بالرمز 401 قبل أن تعرف إيكونوڤا المفتاح، فلا يُسجَّل. راقب تاريخ آخر استخدام للمفتاح بدلًا من ذلك: يتحرك مع كل طلب يجتاز المصادقة، بما في ذلك الطلبات التي رفضها حد المعدل لاحقًا.

هل أستطيع الفلترة حسب المفتاح أو الحالة أو التاريخ؟

ليس في هذا التبويب. تُعرض كل صفوف أحدث 50 طلبًا؛ استخدم وظيفة البحث في متصفحك داخل الصفحة. يُصفّي تبويب السجلات في النشاط حسب المفتاح والخدمة والصوت، ويُنزّل تصدير CSV هناك الإجماليات اليومية.

هل أستطيع تصدير السجل أو قراءته عبر API؟

يُقرأ السجل في البوابة فقط. سجّل كل طلب على جانبك إذا احتجت إلى تاريخ كامل أو نسخة قابلة للمعالجة الآلية.

هل تحصل المهمة على صف واحد أم على صفوف كثيرة؟

صفوف كثيرة، صف لكل طلب. يحصل POST الذي يُنشئ المهمة على صف، سواء كانت متزامنة أو غير متزامنة. ويحصل كل GET ترسله لاستطلاعها على صفه أيضًا.

من يستطيع رؤية السجل؟

مالك مساحة العمل، الذي يملك دوره الإذن developer_api.view. إدارة المفاتيح والـ webhooks تحتاج إلى developer_api.manage؛ أما عرض السجل فلا يحتاجه.