أنشئ حملتي الأولى
الموافقة والتسليم · واجهة API وwebhooks

أنشئ البانرات من نظامك الخاص، عبر API.

الـ API هو الطريقة لطلب البانرات من كودك. جرّبها دون استهلاك كريديت، واستلم webhook (إشعار آلي موقّع) عند انتهاء العمل.

أنشئ حملتي الأولىشاهد الشرح
See the developers page
POST /api/v1/bannersbm_test_…
Idempotency-Key: 7c1e9a52

{
  "prompt": "صباحك، محمّص بإتقان",
  "sizes": ["300x250", "728x90"],
  "locales": ["es-CR", "en-US"]
}

→ 202 { "id": "job_test_…", "status": "queued" }
مفاتيح الاختبار لا تستهلك كريديت.

أنشئ البانرات من كودك

طلب يتضمن الـ prompt والمقاسات واللغات يعيد مهمة تنشئ مفهومًا في جميعها؛ تستعلم عنها حتى تنتهي.

إشعارات موقّعة

سجّل webhook واستلم حدثًا (تم إنشاء البانر، أو التصدير جاهز، أو الموافقة…) بتوقيع يمكنك التحقق منه.

آمن للتجربة

مفاتيح الاختبار تعيد بانرًا تجريبيًا دون ذكاء اصطناعي أو كريديت. وإذا أعدت طلبًا بمفتاح idempotency نفسه، لا يُحتسب مرتين.

كيف يُستخدم

من المفتاح إلى البانر، في ثلاث خطوات.

  1. تنشئ مفتاحًا

    مفتاح اختبار (bm_test_…) للبدء، أو مفتاح إنتاج (bm_live_…). يُعرض كاملًا مرة واحدة فقط.

  2. تُرسل الطلب

    ترسل الـ prompt والمقاسات واللغات، مع ترويسة idempotency.

  3. تنتظر الإشعار

    تستعلم عن المهمة، أو تستلم الـ webhook عند جهوز البانر.

بيانات أساسية

التكاليف والحدود والمتطلبات.

متاح في
خطط الفريق والوكالة والمؤسسات.
المفاتيح
مفاتيح إنتاج واختبار؛ يُحفظ بصمة فقط، لا القيمة.
Webhook events
All 13 documented events are emitted today, including banner.generated, generation.failed, review.approved, and export.ready.
Signature
Standard Webhooks: webhook-id, webhook-timestamp, and webhook-signature headers (HMAC SHA-256, with a 5-minute tolerance) on every notice.

ميزات ذات صلة

التصديراطلب التصدير من كودك.شاهد الأمانالمفاتيح والصلاحيات وسجل كل إجراء.شاهد الفريق والأدوارمن يمكنه إنشاء المفاتيح وwebhooks.شاهد

تعلّم استخدامه خطوة بخطوة

إنشاء بانر بالـ APIالشرحاستلام الإشعارات عبر webhooksالشرح

أمثلة بانرات بهذه الميزة

Nébula · تمويل
Marejada · سفر
Pulso · رياضة

أسئلة حول واجهة api وwebhooks

في أي خطط تتوفر الـ API؟

في خطة الفريق (99 دولارًا شهريًا)، والوكالة (299 دولارًا شهريًا)، والمؤسسات (ابتداءً من 1.500 دولار شهريًا). خطة Starter لا تشمل الـ API ولا الـ webhooks.

هل أستهلك كريديت عند التجربة؟

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

ماذا يحدث إذا أعدت طلبًا؟

مع ترويسة Idempotency-Key، يعيد تكرار الطلب نفسه النتيجة السابقة بدلًا من احتساب الكريديت مرة أخرى.

How do I know a webhook is from BannerMotion?

Each notice carries the webhook-id, webhook-timestamp, and webhook-signature headers of the Standard Webhooks standard: an HMAC SHA-256 signature you verify with your webhook secret. The SDKs ship the verification ready to use.

Are there SDKs?

There are TypeScript and Python clients, not published yet [date to be confirmed]; ask for them at soporte@bannermotion.com. For any other language, use a client generated from the OpenAPI 3.1 specification.

اربط BannerMotion بمنصتك.

جرّبه مع حملة حقيقية.

إنشاء حملتي الأولىتحدّث إلى المبيعات