الطلبات والردود
الطلبات هي JSON أو multipart/form-data؛ الإجابات هي JSON. كل استجابة تحمل عنوان X-Curriculo-Request-Id . اقتبسها عندما تتصل بالدعم حتى نجد المكالمة الدقيقة
الطرق
- العمليات المتزامنة تنتهي في قطعة متأخرة:
/parse/,/evaluate/,/jobs/,/translate/,/detect-language/,/summary/,/transcribe/,/prompt/. - يتم توثيق مسارات المهام الخلفية دون واحدة:
/{op}/asyncو/{op}/tasks/{task_id}. - يتم توثيق مسارات التفتيش دون واحدة:
/screening-interviewو/screening-interview/{screening_id}.
أنواع المحتوى
| العملية | الاعتقادات |
|---|---|
/parse/, /evaluate/, /prompt/, /transcribe/ | multipart/form-data |
/detect-language/, /jobs/, /screening-interview | application/json |
/translate/ | application/json النص، أو multipart/form-data لإرسال وثائق PDF أو DOCX |
/summary/ | application/json للانسخارات، أو multipart/form-data لإرسال التسجيلات أو وثائق النسخة |
/{op}/async | application/json مع قائمة الروابط، أو multipart/form-data مع تحميلات (يمكن تكرار حقل الروابط أو إرسال واحد لكل سطر) |
حدود حجم الطلب
| الحد | القيمة | ينطبق على |
|---|---|---|
| هيئة الطلب | 12 MB | كل مكالمة، باستثناء /summary/. يتم رفض الطلبات الكبيرة في الحافة مع 413 قبل المصادقة. |
| وثيقة واحدة | 10 MB | files, file, resume_pdfs, resume_pdf, job_file، والوثائق المرسلة إلى /translate/ |
| الوثائق حسب الطلب | 10 | /parse/, /evaluate/, /translate/ (ملفات) ، /summary/ (مقابلات أو ملفات media ) |
| النصوص حسب الطلب | 200 | /translate/, /detect-language/ |
| الشخصيات | 50,000 | /translate/ (جميعًا على texts، لكل وثيقة) ، /detect-language/ (كل نص) |
| نص النسخ | 200 ألف حرف | /summary/ transcript_text |
| وثيقة النسخة | 50 MB | /summary/ نسخة PDF أو DOCX |
| التسجيل ، متزامن | 100 MB | /summary/ media |
| التسجيل ، متزامن | 12 MB | /transcribe/ media |
| تحميل إلى مهمة خلفية | 12 MB لكل ملف | /{op}/async متعددة الأجزاء |
| الروابط لكل مهمة خلفية | 25 | file_urls, resume_urls |
| التسجيل عن طريق الرابط | 1 GB و 2 ساعات | /summary/async, /transcribe/async media_url |
فوق أي سقف، API يعود 413. تقسيم عبء العمل، أو إرسال التسجيلات الطويلة عن طريق الرابط إلى طريق التزامن .
المكالمة المزمنة تحد أيضا من خلال 300 ثانية وقت الطلب. التسجيل الكبير الذي يستغرق وقتًا أطول لإجراءه يعيد
504، لذلك يفضل/summary/asyncمقابلات طويلة.
أشكال الاستجابة
كل عملية تأخذ قائمة تتبع قاعدة واحدة: إرسال عنصر واحد، الحصول على شيء من ذلك العنصر؛ إرسال عدة، الحصول على نتيجة واحدة لكل عنصر، في ترتيب إدخال.
العديد من البنود تعيد إدخال واحد لكل إدخال:
{
"results": [
{ "index": 0, "status": "ok", "data": { … } },
{ "index": 1, "status": "error", "error": { "status": 400, "detail": "…" } },
{ "index": 2, "status": "ok", "data": { … } }
]
}تبقى حالة HTTP 200 عندما يتم قبول اللحظة نفسها، لذلك اقرأ status لكل عنصر. واحد غير قراءة CV لا يكلفك تسعة أخرى. انظر الإعدادات.
الاستخدام والإنفاق
لا توجد بيانات عن التكاليف في الإجابات. المكالمات والخطأ والتأخير والشحنة المتقدمة موجودة في Console → Usage، والتي يمكن تصفيتها بواسطة مفتاح. انظر التسعير والفواتير.
نظافة المدخلات
- يتم رفض المفاتيح المكررة في جسم JSON (
/translate/،/summary/،/detect-language/) مع تسمية400للمفتاح. - يتم رفض الملفات المستندة التي تحميها كلمة المرور مع
400. إزالة كلمة المرور وإعادة إرسالها. - أسماء الحقول حساسة للقضية
الإصدار
لا يوجد عنوان إصدار API. يتم نسخة السطح عن طريق المسار، وتغيرات إضافية (حقول اخيارية جديدة، عمليات جديدة) السفن دون كسر المكالمات القائمة. اكتب العملاء الذين يتجاهلون حقل الاستجابة غير المعروفة.
Updated