واجهات برمجة تطبيقات بمخطط لكل مستأجر
لا توجد مرجعية ثابتة لواجهة برمجة التطبيقات الخاصة بـ Twenty. لكل مساحة عمل مخططها الخاص — عند إضافة كائن مخصص (مثلInvoice)، يحصل فورًا على نقاط نهاية REST وGraphQL مطابقة لتلك الخاصة بالكائنات المدمجة مثل Company أو Person. تُولَّد واجهة برمجة التطبيقات من المخطط، لذا تستخدم نقاط النهاية أسماء الكائنات والحقول لديك مباشرة — بدون معرّفات غامضة.
وثائق واجهة برمجة التطبيقات الخاصة بمساحة عملك متاحة ضمن الإعدادات → واجهات برمجة التطبيقات وخطافات الويب بعد إنشاء مفتاح API. يتضمن ساحة تجريبية تفاعلية يمكنك من خلالها تنفيذ استدعاءات حقيقية على بياناتك.
واجهتا برمجة تطبيقات
واجهة برمجة التطبيقات الأساسية —/rest/ و/graphql/
عمليات CRUD على السجلات: الأشخاص، الشركات، الفرص، وكائناتك المخصصة. استعلام، تصفية، والتنقل عبر العلاقات.
واجهة برمجة تطبيقات البيانات الوصفية — /rest/metadata/ و/metadata/
إدارة المخطط: إنشاء/تعديل/حذف الكائنات والحقول والعلاقات. هذه هي الطريقة لتغيير نموذج بياناتك برمجيًا.
كلاهما متاحان عبر REST وGraphQL. تضيف GraphQL عمليات upsert على دفعات وإمكانية التنقل عبر العلاقات في استعلام واحد. نفس البيانات الأساسية بأي من الطريقتين.
عناوين URL الأساسية
| البيئة | عنوان URL الأساسي |
|---|---|
| السحابة | https://api.twenty.com/ |
| الاستضافة الذاتية | https://{your-domain}/ |
المصادقة
عمليات الدفعات
يدعم كلٌّ من REST وGraphQL التجميع لما يصل إلى 60 سجلًا لكل طلب — إنشاء أو تحديث أو حذف. كما تدعم GraphQL عملية upsert على دفعات (إنشاء-أو-تحديث في استدعاء واحد) باستخدام أسماء جمع مثلCreateCompanies.
حدود المعدل
| الحد | القيمة |
|---|---|
| الطلبات | 100 استدعاء في الدقيقة |
| حجم الدفعة | 60 سجل لكل استدعاء |