موارد المطورين

مبني من أجل المطورين، بأيدي المطورين

واجهة 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 الأساسيhttps://api.claform.com/api/v1

جميع نقاط النهاية مسبوقة بعنوان URL الأساسي المُصدَّر

المصادقةAuthorization: Bearer

أنشئ مفاتيح API من لوحة التحكم أو استخدم JWT للوصول المحدّد بنطاق المستخدم

تحديد المعدل60 طلبًا/الدقيقة

تحديد افتراضي للمعدل لكل مفتاح مع توفّر مستويات أعلى؛ تُظهر الترويسات الحصة المتبقية

الصيغةJSON (application/json)

جميع الطلبات والاستجابات تستخدم ترميز JSON مع UTF-8

التشفيرTLS 1.3 مطلوب

جميع حركة مرور 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());

نقاط النهاية الرئيسية

GET
/api/v1/surveys

إدراج جميع الاستبيانات مع التقسيم إلى صفحات والتصفية والفرز

POST
/api/v1/surveys

إنشاء استبيان جديد بالأسئلة والمنطق والإعدادات

GET
/api/v1/surveys/:id/responses

استرجاع ردود الاستبيان مع تصفية متقدمة

POST
/api/v1/email-campaigns

إطلاق حملات توزيع بالبريد الإلكتروني إلى قوائم الجمهور

GET
/api/v1/analytics/surveys/:id

الحصول على التحليلات مع الرسوم البيانية والاتجاهات ورؤى الذكاء الاصطناعي

POST
/api/v1/webhooks

تسجيل نقاط نهاية خطافات الويب للأحداث في الوقت الفعلي

أكثر من 75 نقطة نهاية تغطي الاستبيانات والأسئلة والردود والحملات والتحليلات والجماهير وجهات الاتصال والتكاملات وخطافات الويب والإدارة. تقسيم كامل إلى صفحات وتصفية وفرز على جميع نقاط نهاية الإدراج.

حزم تطوير أصلية

4 حزم تطوير أصلية على نواة مشتركة

ضمّن الاستبيانات بشكل أصلي في أي تطبيق. أربع حزم تطوير أصلية مبنية على محرّك نواة TypeScript مشترك، كل منها يدعم جميع أنواع الأسئلة الـ30+ والعمل دون اتصال وتطبيق السمات وإمكانية الوصول ومعالجة الأحداث في الوقت الفعلي.

TypeScript Core

الويب وNode.js · نحو 27 كيلوبايت مضغوطة

npm install @claform/sdk-core
  • TypeScript خالص، بلا تبعيات
  • أكثر من 35 نوع سؤال
  • دعم العمل دون اتصال
  • بنية مدفوعة بالأحداث
مثال TypeScript Core
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 خطافًا مخصصًا
  • وضع الطلبات في قائمة الانتظار دون اتصال
  • دعم إمكانية الوصول
مثال React Native
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 عنصر سؤال
مثال Flutter
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
  • دعم النوع الديناميكي
مثال iOS (Swift)
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
مثال Android (Kotlin)
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 دقائق.

01

احصل على مفتاح API الخاص بك

أنشئ حسابًا مجانيًا وولّد مفتاح API من لوحة التحكم. تُحدَّد المفاتيح بنطاق كل مشروع مع أذونات وحدود معدل قابلة للتهيئة.

02

ثبّت حزمة تطوير

اختر من بين 4 حزم تطوير أصلية أو استخدم واجهة REST API مباشرةً. تتضمّن كل حزمة تعريفات أنواع/TypeScript كاملة، وتوثيقًا شاملًا، وأمثلة برمجية.

03

أطلق منتجك

أنشئ استبيانك الأول، وضمّنه في تطبيقك، وابدأ بجمع الردود. استخدم خطافات الويب لتشغيل سير عمل في الوقت الفعلي.

أكثر من 75
نقطة نهاية API
4
حزم تطوير أصلية
99.9%
وقت تشغيل API
أقل من 100 مللي ثانية
متوسط زمن الاستجابة

ابدأ البناء اليوم

احصل على مفتاح API المجاني وأجرِ أول استدعاء لـ API في دقائق. تشمل طبقتنا المجانية السخية 1,000 طلب API يوميًا.

وصول مجاني إلى APIبلا حاجة إلى بطاقة ائتمانتوثيق كامل