فيديوهاتيالتوثيق

إنشاء مشروع

إنشاء مشروع

POST/v1/projects

تدعم هذه العملية مصادقة ملف ارتباط جلسة لوحة التحكم. استدعها من شيفرة خادم موثوقة فقط، ولا تنشئ المتصفحات ملف الجلسة أو تكشفه.

ينشئ مشروعًا جديدًا ضمن حدود الخطة، ولا يسمح بذلك إلا لحساب موافَق عليه عبر جلسة لوحة التحكم.

حد المعدّل: 60 طلبًا لكل 60 ثانية لكل جلسة.

رموز الخطأ: unauthorized (401), account_not_approved (403), not_found (404), invalid_name (400).

المصادقة

  • sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معامل projectId عند استخدام الجلسة.

المعاملات

لا تأخذ هذه العملية أي معاملات.

جسم الطلب

إلزامي

نوع المحتوى: application/json

المخطّط: ProjectCreateRequest

{
  "name": "Arabic Calculus Course"
}

الاستجابات

الرمزالمعنى
201أُنشئ المشروع على خطة الحساب الحالية، وتكون Trial أثناء التجربة ذات 14 يومًا.
400فشل التحقق من جسم الطلب أو معاملاته. يذكر وصف العملية قيم error.code الدقيقة.
401لم تُقدَّم بيانات اعتماد صالحة.
403بيانات الاعتماد صالحة لكنها لا تسمح بهذا الإجراء. يذكر وصف العملية قيم error.code الدقيقة.
404المورد غير موجود أو غير مرئي لهذا المستدعي.
429تم تجاوز حد المعدّل.

مثال على الطلب

{
  "name": "Arabic Calculus Course"
}