موارد المطورين
مبني من أجل المطورين، بأيدي المطورين
واجهة REST API قوية، و4 حزم تطوير أصلية على نواة TypeScript مشتركة، وخطافات ويب في الوقت الفعلي، وأكثر من 80 تكاملًا. كل ما تحتاجه لتضمين الاستبيانات في أي تطبيق أو سير عمل.
curl -X GET https://api.claform.com/api/v1/surveys \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"واجهة REST API
واجهة REST API شاملة
واجهة RESTful موثّقة بالكامل بعناوين URL متوقعة وموجّهة للموارد، وأجسام طلبات/استجابات بصيغة JSON، وطرق HTTP قياسية.
أساسيات API
جميع نقاط النهاية مسبوقة بعنوان URL الأساسي المُصدَّر
أنشئ مفاتيح API من لوحة التحكم أو استخدم JWT للوصول المحدّد بنطاق المستخدم
تحديد افتراضي للمعدل لكل مفتاح مع توفّر مستويات أعلى؛ تُظهر الترويسات الحصة المتبقية
جميع الطلبات والاستجابات تستخدم ترميز JSON مع UTF-8
جميع حركة مرور API مشفّرة من طرف إلى طرف عبر HTTPS
مثال على المصادقة
// Using API Key (recommended for server-to-server)
const headers = {
'Authorization': 'Bearer sk_live_your_api_key',
'Content-Type': 'application/json',
};
// Using JWT (for user-scoped access)
const { token } = await fetch('/api/v1/auth/login', {
method: 'POST',
body: JSON.stringify({ email, password }),
}).then(r => r.json());نقاط النهاية الرئيسية
/api/v1/surveysإدراج جميع الاستبيانات مع التقسيم إلى صفحات والتصفية والفرز
/api/v1/surveysإنشاء استبيان جديد بالأسئلة والمنطق والإعدادات
/api/v1/surveys/:id/responsesاسترجاع ردود الاستبيان مع تصفية متقدمة
/api/v1/email-campaignsإطلاق حملات توزيع بالبريد الإلكتروني إلى قوائم الجمهور
/api/v1/analytics/surveys/:idالحصول على التحليلات مع الرسوم البيانية والاتجاهات ورؤى الذكاء الاصطناعي
/api/v1/webhooksتسجيل نقاط نهاية خطافات الويب للأحداث في الوقت الفعلي
أكثر من 75 نقطة نهاية تغطي الاستبيانات والأسئلة والردود والحملات والتحليلات والجماهير وجهات الاتصال والتكاملات وخطافات الويب والإدارة. تقسيم كامل إلى صفحات وتصفية وفرز على جميع نقاط نهاية الإدراج.
حزم تطوير أصلية
4 حزم تطوير أصلية على نواة مشتركة
ضمّن الاستبيانات بشكل أصلي في أي تطبيق. أربع حزم تطوير أصلية مبنية على محرّك نواة TypeScript مشترك، كل منها يدعم جميع أنواع الأسئلة الـ30+ والعمل دون اتصال وتطبيق السمات وإمكانية الوصول ومعالجة الأحداث في الوقت الفعلي.
TypeScript Core
الويب وNode.js · نحو 27 كيلوبايت مضغوطة
npm install @claform/sdk-core- TypeScript خالص، بلا تبعيات
- أكثر من 35 نوع سؤال
- دعم العمل دون اتصال
- بنية مدفوعة بالأحداث
import { SurveySDK } from '@claform/sdk-core';
const sdk = new SurveySDK({
apiKey: 'your-api-key',
baseUrl: 'https://api.claform.com/api/v1',
});
const survey = await sdk.loadSurvey('survey-id');
const response = await sdk.submitResponse(answers);React Native
iOS وAndroid · 262 كيلوبايت + النواة
npm install @claform/sdk-react-native- مكوّنات واجهة مستخدم أصلية
- 12 خطافًا مخصصًا
- وضع الطلبات في قائمة الانتظار دون اتصال
- دعم إمكانية الوصول
import { SurveyProvider, SurveyView } from '@claform/sdk-react-native';
function App() {
return (
<SurveyProvider apiKey="your-api-key">
<SurveyView
surveyId="survey-id"
onComplete={(response) => console.log(response)}
/>
</SurveyProvider>
);
}Flutter
iOS وAndroid · Dart خالص
flutter pub add claform_sdk_flutter- تطبيق سمات Material 3
- إدارة الحالة عبر Provider
- مزامنة دون اتصال
- أكثر من 30 عنصر سؤال
import 'package:claform_sdk_flutter/claform_sdk_flutter.dart';
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return SurveyProvider(
apiKey: 'your-api-key',
child: SurveyScreen(surveyId: 'survey-id'),
);
}
}iOS (Swift)
iOS 15 فأحدث · بلا تبعيات خارجية
.package(url: "https://github.com/claform/sdk-ios")- عروض SwiftUI أصلية
- SPM وCocoaPods
- جسر UIKit
- دعم النوع الديناميكي
import ClaformSDK
struct ContentView: View {
var body: some View {
SurveyView(
apiKey: "your-api-key",
surveyId: "survey-id"
) { response in
print("Completed: \(response)")
}
}
}Android (Kotlin)
API 24 فأحدث · Jetpack Compose
implementation("com.claform:sdk-android:1.0.0")- واجهة Compose
- سمة Material3
- كتالوج إصدارات Gradle
- Coroutines وFlow
import com.claform.sdk.SurveyScreen
import com.claform.sdk.SurveyViewModel
@Composable
fun SurveyPage(viewModel: SurveyViewModel = viewModel()) {
SurveyScreen(
apiKey = "your-api-key",
surveyId = "survey-id",
onComplete = { response -> /* handle */ }
)
}خطافات الويب
إشعارات الأحداث في الوقت الفعلي
اشترك في الأحداث واحصل على استدعاءات HTTP فورية عند وقوع أمور في حسابك. لا حاجة إلى الاستقصاء.
الأحداث المدعومة
response.createdيُطلق عند تقديم رد استبيان جديد
response.updatedيُطلق عند تحديث رد جزئي أو إكماله
survey.publishedيُطلق عند نشر استبيان وإتاحته مباشرةً
survey.closedيُطلق عند إغلاق استبيان أمام الردود الجديدة
campaign.sentيُطلق عند إطلاق حملة توزيع
campaign.deliveredيُطلق عند تسليم رسائل الحملة
campaign.bouncedيُطلق عند ارتداد رسائل الحملة
contact.opted_outيُطلق عند إلغاء اشتراك جهة اتصال أو إلغاء موافقتها
ميزات خطافات الويب
- التحقق من التوقيع
كل حمولة خطاف ويب موقّعة بـ HMAC-SHA256 باستخدام مفتاحك السري لضمان تسليم محصّن ضد العبث.
- إعادة المحاولة التلقائية
تُعاد محاولة عمليات التسليم الفاشلة بتراجع أُسّي حتى 5 مرات على مدى 24 ساعة.
- سجلات التسليم
سجل تسليم كامل بأجسام الطلب/الاستجابة ورموز الحالة والتوقيت لأغراض التصحيح.
- تصفية الأحداث
اشترك فقط في الأحداث التي تهمّك. صفِّ حسب الاستبيان أو الحملة أو نوع الحدث.
{
"event": "response.created",
"timestamp": "2026-04-05T14:30:00Z",
"data": {
"responseId": "resp_abc123",
"surveyId": "srv_xyz789",
"status": "completed",
"completionTime": 245,
"answers": [...]
},
"signature": "sha256=..."
}التكاملات
اربط منظومتك بالكامل
موصّلات جاهزة لأشهر المنصات، بالإضافة إلى Zapier وMake للاتصال بآلاف المنصات الأخرى.
Zapier
اتصل بأكثر من 5,000 تطبيق عبر المُشغِّلات والإجراءات
Make
أتمتة سير عمل مرئية مع سيناريوهات معقّدة
Salesforce
مزامنة الردود مع جهات الاتصال والعملاء المحتملين والحالات
HubSpot
ربط بيانات الاستبيان بالصفقات وجهات الاتصال والتذاكر
Mailchimp
تشغيل الاستبيانات من حملات البريد الإلكتروني والشرائح
Klaviyo
تضمين الاستبيانات في مسارات رحلة العميل
Slack
توزيع الاستبيانات وتلقّي الإشعارات في القنوات
Microsoft Teams
إرسال الاستبيانات عبر روبوتات وعلامات تبويب Teams
بداية سريعة
جاهز للعمل في 3 خطوات
من التسجيل إلى أول استدعاء لـ API في أقل من 5 دقائق.
احصل على مفتاح API الخاص بك
أنشئ حسابًا مجانيًا وولّد مفتاح API من لوحة التحكم. تُحدَّد المفاتيح بنطاق كل مشروع مع أذونات وحدود معدل قابلة للتهيئة.
ثبّت حزمة تطوير
اختر من بين 4 حزم تطوير أصلية أو استخدم واجهة REST API مباشرةً. تتضمّن كل حزمة تعريفات أنواع/TypeScript كاملة، وتوثيقًا شاملًا، وأمثلة برمجية.
أطلق منتجك
أنشئ استبيانك الأول، وضمّنه في تطبيقك، وابدأ بجمع الردود. استخدم خطافات الويب لتشغيل سير عمل في الوقت الفعلي.
ابدأ البناء اليوم
احصل على مفتاح API المجاني وأجرِ أول استدعاء لـ API في دقائق. تشمل طبقتنا المجانية السخية 1,000 طلب API يوميًا.