واجهة النماذج البرمجية
يمكن لكل نموذج أن يكون واجهة برمجية: يرسل إليه موقعك أو تطبيقك الخاص ردودًا.
تفعيلها
- 1فعّل واجهات النماذج في إعدادات النماذج للقاعدة.
- 2افتح تبويب API في النموذج وفعّله.
- 3انسخ مفتاحه، الذي يُعرض مرة واحدة؛ وأنشئ مفتاحًا جديدًا متى شئت.
نقاط الوصول
- GET /api/forms/:id
- حقول النموذج، لعرضه.
- POST /api/forms/:id/submissions
- إرسال الردود، يُتحقّق منها كما يتحقّق النموذج.
- GET /api/forms/:id/submissions
- قراءة الإرسالات، الأقدم أولًا، بالمفتاح.
- GET /api/forms/:id/submissions/:sid
- قراءة إرسال واحد.
قواعدها
- أرسل المفتاح كـ Authorization: Bearer <key>.
- يقبل النموذج المفتوح الإرسالات دون مفتاح؛ وقراءتها تتطلّبه دائمًا.
- يرسل كل عنوان عددًا محدودًا من الإرسالات في الدقيقة، حسب باقتك.
- لا يُحفظ إلا ما يطلبه النموذج، بما فيه الملفات.
أين تذهب الردود
يُحفظ كل إرسال ردًّا على النموذج، سواء كان التطبيق مفتوحًا أم لا، ويشغّل سير عملك.