Public API

واجهة API لإدارة حساب Submeto من خادم إلى خادم.

متاح لكل مستخدم نشط في Submeto، بما في ذلك مستخدمو Free. يكون الوصول إلى Public API معطّلًا افتراضيًا، ويجب تفعيله في Dashboard بعد مراجعة مخاطر الأمان.

مصمم للخوادم لا للمتصفحات

صُمم Public API للأتمتة التي تعمل على بنية تحتية تتحكم بها — مثل cron jobs وbackends وCI pipelines. يدير النماذج والحقول ويقرأ الإرسالات ويعالجها. وهو منفصل عن Form Submission API الذي يستقبل بيانات النماذج من زوار موقعك؛ إذا كان هذا ما تحتاجه، فابدأ من وثائق Form Submission API.

ما الذي يمكنك فعله؟

تُخوّل كل عملية بالنطاقات الموجودة في API Key وبالنماذج الممنوحة لذلك المفتاح.

• إدارة النماذج — عرض النماذج وإنشاؤها وتحديثها وحذفها، وفق نطاقات forms:read وforms:create وforms:update وforms:delete.
• تعريف الحقول — قراءة إعدادات حقول النموذج وتحديثها باستخدام نطاقي forms:read وforms:update.
• قراءة الإرسالات — عرض الإرسالات لكل نموذج ووضع علامة مقروء باستخدام نطاقي submissions:read وsubmissions:mark_read.
• الوصول إلى الملفات — الحصول على صلاحية تنزيل مخصصة وقصيرة الأجل للملفات المرفقة بالإرسالات.
• تشغيل مسارات العمل — فحص المسودات وتعديلها، والتحقق من الإصدارات ونشرها، وتشغيل اختبارات جافة، ومراجعة عمليات التشغيل، وإعادة محاولة حالات الفشل المؤهلة.

حدود الأمان

• تُصادق API Keys على خادمك، وليس على متصفح أو تطبيق جوّال. استخدمها فقط في بيئات خادم إلى خادم عبر HTTPS.
• تحمل Keys نطاقات محددة ولا يمكن منحها إلا للنماذج المختارة. لا تظهر الموارد غير الممنوحة للمفتاح.
• لا تتضمن الاستجابات الأسرار أو رموز النماذج أو إعدادات التكامل أو حمولات الإرسال الخام.
• تتطلب العمليات التدميرية تأكيدًا على مستوى التطبيق بالإضافة إلى النطاقات.