واجهة النماذج البرمجية

يمكن لكل نموذج أن يكون واجهة برمجية: يرسل إليه موقعك أو تطبيقك الخاص ردودًا.

تفعيلها

  1. 1فعّل واجهات النماذج في إعدادات النماذج للقاعدة.
  2. 2افتح تبويب API في النموذج وفعّله.
  3. 3انسخ مفتاحه، الذي يُعرض مرة واحدة؛ وأنشئ مفتاحًا جديدًا متى شئت.

نقاط الوصول

GET /api/forms/:id
حقول النموذج، لعرضه.
POST /api/forms/:id/submissions
إرسال الردود، يُتحقّق منها كما يتحقّق النموذج.
GET /api/forms/:id/submissions
قراءة الإرسالات، الأقدم أولًا، بالمفتاح.
GET /api/forms/:id/submissions/:sid
قراءة إرسال واحد.

قواعدها

  • أرسل المفتاح كـ Authorization: Bearer <key>.
  • يقبل النموذج المفتوح الإرسالات دون مفتاح؛ وقراءتها تتطلّبه دائمًا.
  • يرسل كل عنوان عددًا محدودًا من الإرسالات في الدقيقة، حسب باقتك.
  • لا يُحفظ إلا ما يطلبه النموذج، بما فيه الملفات.

أين تذهب الردود

يُحفظ كل إرسال ردًّا على النموذج، سواء كان التطبيق مفتوحًا أم لا، ويشغّل سير عملك.