وثائق Curriculo
بناء سير العمل التوظيف على Curriculo
Curriculo API يحول مواد التوظيف الخام (سيرة ذاتية، متطلبات الوظيفة، تسجيلات المقابلات) إلى بيانات منظمة وجاهزة لاتخاذ القرار. واحد REST API، واحد المفتاح الحامل من وحدة التحكم المطور، لا ATS تسجيل الدخول مطلوب.
5 دولار إئتمان مجاني، مفتاح واحد، لا تسجيل الدخول ATS
Base URL https://api.curriculo.me/public
curl -X POST https://api.curriculo.me/public/parse/ \
-H 'Authorization: Bearer key_abc123_yoursecret' \
-F 'files=@/path/to/candidate.pdf'ابدأ من هنا
- بدء سريعإنشاء حساب، إصدار مفتاح وإجراء المكالمة الأولى في ثلاث خطوات.
- لمحة عامة عن APIالنقاط النهائية، المصادقة، الحدود، الأخطاء والأسعار في صفحة واحدة.
- مرجع APIكل حقل طلب لكل عملية
- خادم MCPعمل خط التوظيف الخاص بك من Claude، ChatGPT، Cursor والعملاء الآخرين.
- وكيل البريد الإلكترونيربط صندوق الواردات الخاص بك التوظيف والسيرة الذاتية رسائل البريد الإلكتروني المرسلة إلى عنوان وظيفة تطبيق تصبح المرشحين، مع إرسال والجدول الزمني الآلي.
- لمبني ATSأي Curriculo API يناسب أي خطوة من ATS الخاص بك، مع مثال تكامل.
استخدم Curriculo كطبقة AI لـ ATS الخاص بك، لوحة الوظائف أو سير العمل في التوظيف. منتجك يحتفظ بالمرشحين، الوظائف، الوضع وموظف UI. Curriculo API يقوم بعمل اللغة والتقييم والمقابلة والإعلام وراءه. وهو RESTful API الذي يمنح الوصول البرمجي إلى نفس محركات السيرة الذاتية والتقييم واللغة والمقابلة التي تعمل داخل منتج Curriculo.
ماذا تريد أن تفعل؟
- APIبنيت في منتجتىتحليل السيرة الذاتية، وتقييم المرشحين مقابل وظيفة، ترجمة وتلخيص المقابلات من رمزك الخاص. مفتاح واحد من وحدة التحكم في المطورين
- MCPاستخدمه في Claude، ChatGPT أو Cursorعمل خط التوظيف الخاص بك من Claude، ChatGPT، Cursor والعملاء الآخرين. جزء من Curriculo ATS، مع تسجيل الدخول الخاص به.
- وكيل البريد الإلكترونيأتمتي صندوق الواردات الخاص بيربط صندوق الواردات الخاص بك التوظيف والسيرة الذاتية رسائل البريد الإلكتروني المرسلة إلى عنوان وظيفة تطبيق تصبح المرشحين، مع إرسال والجدول الزمني الآلي.
اجعل أول اتصال لك
- إنشاء حساب. تسجيل الدخول إلى وحدة التحكم .curriculo.me. يتم توفير الحساب عند أول تسجيل دخول، وتُضاف رصيد مجاني لمرة واحدة بقيمة $5.00.
- اصنع مفتاح API في وحدة التحكم، افتح API مفاتيح واختيار إنشاء API مفتاح. المفتاح يبدو مثل
key_<id>_<secret>ويتم عرضه مرة واحدة. لا يمكن استعادتها لاحقاً، لذا احتفظ بها في مكان آمن - استدعاء نقطة النهاية. تنفيذ الطلب في أعلى هذه الصفحة باستخدام المفتاح الخاص بك. تكلفة كشف اللغة $0.001 لكل طلب وتُعطي الإجابة في أقل من ثانية.
Quickstart يمر بنفس الخطوات، ثم يقوم بتحليل السيرة الذاتية.
يمكن أن يستغرق استئناف تحليل ما يصل إلى 90 ثانية لكل مستند. ضع توقيت العميل HTTP فوق خمس دقائق، لأن توقيت 30 ثانية سيتخلى عن المكالمات التي كانت ستنجح.
جرب قبل أن تكتب البرمجة يمكن تشغيل العمليات المتزامنة من صفحة وثائق وحدة التحكم: اضغط على مفتاحك، وعلق سيرتك الذاتية الحقيقية وقراءة الرد.
القدرات
| القدرة | العملية | ما الذي يفعله |
|---|---|---|
| تحليل السيرة الذاتية | POST /parse/ | PDF أو DOCX في، هيكلة JSON خارج: تفاصيل الاتصال، الأدوار، التواريخ، المهارات. ما يصل إلى 10 وثائق لكل طلب. |
| تقييم المرشح | POST /evaluate/ | النتيجة تستأنف مقابل الوظيفة: تحليل ملائمة، الفجوات، الملاءمة. إرسال الوظيفة كنص ملصق، وثيقة JD، أو job_id. |
| تسجيل وظيفة | POST /jobs/ | اختيارية ومجانية. تخزين وصف الوظيفة مرة واحدة وإعادة استخدام job_id العائدة عبر مجموعة متأخرة من السير الذاتية. |
| ترجمة | POST /translate/ | ترجمة سلسلة واحدة، حتى 200 سلسلة، أو كامل PDF و DOCX الوثائق، إلى أي من 202 لغة. |
| اكتشاف اللغة | POST /detect-language/ | رمز لغوي (ISO 639-1، أو FLORES-200 إذا لم يكن هناك أي) لنص واحد أو حتى 200 في دفعة. |
| تلخيص المقابلة | POST /summary/ | سجل، وثيقة سجل أو تسجيل في؛ أبرز، الأعلام الحمراء، المهارات وتوصية التوظيف خارج. |
| نسخة | POST /transcribe/ | تسجيل في، نسخة خارج، دون ملخص. |
| أطلب السيرة الذاتية | POST /prompt/ | قم بتوليد أو تحرير أو ترجمة أو طرح أسئلة حول السيرة الذاتية المعلقة على بطاقة الاعتماد الخاصة بك، بلغة بسيطة. دولة. |
| مقابلة الفحص | POST /screening-interview | دعو المرشحين إلى فحص مُستضاف ومُسجل وتلقي كل إجابة مُوقعة، مع نسخة وربط تسجيل، على خادمك. |
العمل الطويل (حزمة سير العمل المتأخرة ، تسجيل مدته ساعة) يعمل في الخلفية: انظر معالجة الخلفية واستدعاءات. كل حقل طلب لكل عملية في مرجع API.
المفاهيم الأساسية
- المصادقةأرسل مفتاح وحدة التحكم الخاص بك كرمز مفتاح واحد يؤذن كل عملية، على الفور. لا توجد أوراق اعتماد لكل نقطة نهاية، لا نطاقات ولا شيء لتمكين.
- عدم التزامن والاتصالات اللاحقةتحليل وتقييم وتلخيص ونسخ وترجمة أيضا تشغيل في الخلفية: POST /{op}/async الإجابات 202 مع task_id في وقت واحد. قم بإجراء استطلاع على المهمة أو تلقي إعادة الاتصال الموقعة
- التجميعلا توجد نقطة نهائية منفصلة للمجموعة: القائمة هي المجموعة. ما يصل إلى 10 وثائق لكل طلب للتحليل والتقييم، ما يصل إلى 200 نصًا للترجمة واكتشاف اللغة.
- القيود والأخطاء600 طلب في الدقيقة لكل مفتاح، 2000 لكل عنوان IP، وقت استراحة طلب 300 ثانية. العمل الثقيل يعمل على القدرة المشتركة في جميع أنحاء الخدمة الأخطاء هي JSON مع حالة HTTP التي تهم.
صيغ الأخطاء، رموز الحالة، معرف الطلبات وإرشادات إعادة المحاولة على الأخطاء. أنواع المحتوى وحدود الحجم هي على طلبات والردود.
التسعير
مدفوع مسبقًا حسب الطلب من رصيد واحد $0.001 للكشف عن لغة، $0.01 لكل سيرتك الذاتية المحللة أو التقييم، و مرة واحدة $5.00 الائتمان المجاني للبدء. الطلبات المرفوضة لا تُفرض أبدًا شاهد كل الأسعار.
الاندماج لفرق التوظيف
Curriculo ATS، منتج التوظيف الذي يقوم فريقك بالتوقيع عليه، يرتبط أيضاً بالأدوات التي يستخدمها فريقك بالفعل. هذه منتجات منفصلة عن API العامة، مع تسجيل دخول خاص بهم.
- Curriculo ATS MCP خادم: عمل خط التوظيف الخاص بك من Claude، ChatGPT، Cursor والعملاء الآخرين.
- وكيل البريد الإلكتروني: ربط صندوق الواردات الخاص بك التوظيف والوكيل يبتلع استئناف رسائل البريد الإلكتروني المرسلة إلى عنوان وظيفة التقدم بطلبات إلى المرشحين، الآليات ترسل وإدارة التقويمات.
- سلك من خلال MCP: استخدم Curriculo ATS من سلك مع مساعد قادر على MCP.
الحساب والقاعدة URL
| البيئة | القاعدة URL | أوراق اعتماد |
|---|---|---|
| الإنتاج | https://api.curriculo.me/public | مفتاح وحدة التحكم key_<id>_<secret> |
كل عملية تعيش تحت هذه القاعدة URL توجيه عميلك إلى تلك القاعدة وإضافة مسار العملية، على سبيل المثال https://api.curriculo.me/public/parse/. الإنتاج هو البيئة المنشورة الوحيدة، والحسابات الجديدة تبدأ مع $5.00 الائتمان المجاني، حتى تتمكن من اختبار على الإنتاج مع المستندات الخاصة بك.
| العنوان | القيمة | مطلوب |
|---|---|---|
Authorization | Bearer key_<id>_<secret>مفتاح جهاز التحكم API الخاص بك | نعم .. |
Content-Type | application/json أو multipart/form-data، اعتمادا على العملية | نعم، عند الطلبات مع الجثة |
console.curriculo.me هو المكان الذي يبدأ فيه الحساب وأين يتم إدارته: تسجيل الدخول، مفاتيح API، الاستخدام والفواتير. مفتاح API الخاص بك يعمل التوظيف. لا يمكنه عمداً عمل مفاتيح أو تغيير الفواتير، لذا لا يمكن أن يتصاعد المفتاح المسرب إلى مراقبة الحساب. انظر Developer Console.
الطلبات هي JSON أو multipart/form-data؛ الإجابات هي JSON ، باستثناء صفحات 413 الخاصة بالحافة (طلب كبير الحجم) و 404 (مسار خارج /public/). العمليات المتزامنة تنتهي في إشارة خفيفة (/parse/). يتم توثيق مسارات المهام الخلفية (/parse/async،/parse/tasks/{task_id}) ومسارات الفحص (/screening-interview) دون واحدة. لا يوجد عنوان إصدار API ولا إصدار في المسار ، وتغييرات إضافية (حقول اختيارية جديدة ، عمليات جديدة) يتم شحنها دون كسر المكالمات الموجودة.
ماذا بعد ذلك؟
- قم بتحليل سيرتك الذاتية الأولى: Quickstart، الحساب، المفتاح والاتصال الأول في ثلاث خطوات.
- درجة السيرة الذاتية مقابل الوظيفة: تقييم المرشح.
- إرسال العديد من المستندات في وقت واحد: التجميع ، كيفية عمل القوائم ، سقف كل نقطة نهاية ، وأخطاء لكل عنصر.
- معالجة الحزمة المتأخرة أو التسجيل الطويل: معالجة الخلفية واستدعاءات، عمل طويل دون الحفاظ على اتصال مفتوح.
- خطة الحجم: حدود السعر، السقف لكل مفتاح و لكل IP ، القدرة المشتركة ، وموعد الطلب.
- توليد عميل مُصنّف: SDKs العميل.
- ميزانية العمل: التسعير والفواتير، سعر كل عملية، الائتمان المجاني والإضافة.
- إضافة AI إلى ATS الخاص بك: لمبني ATS، الذي Curriculo API يناسب أي خطوة من ATS الخاص بك، مع مثال التكامل.
FAQ
ما هي قاعدة URL من Curriculo API؟
https://api.curriculo.me/public. Every operation lives under it, and production is the only published environment.
كيف أتحقق من صحتي؟
إرسال مفتاح وحدة التحكم للمطور كرمز حامل: الإذن: مفتاح حامل_<id>_<secret>.
هل هناك نقطة نهائية للقطعة؟
لا، لا، لا. القائمة هي دفعة: إرسال العديد من الوثائق أو السلاسل في طلب واحد وكل نتيجة تعود بالترتيب.
ماذا يحدث مع العمل الطويل؟
استخدم مسار async، /{op}/async، واستطلاع المهمة أو تلقي رد استدعاء موقعة.
آخر تحديث