Maak mijn eerste campagne
Goedkeuren en leveren · API en webhooks

Maak banners vanuit je eigen systeem, met een API.

Een API is de manier om banners vanuit je code aan te vragen. Test hem zonder credits te gebruiken en ontvang een webhook (een automatische, ondertekende melding) wanneer het werk klaar is.

Maak mijn eerste campagneBekijk de tutorial
See the developers page
POST /api/v1/bannersbm_test_…
Idempotency-Key: 7c1e9a52

{
  "prompt": "Jouw ochtend, goed gebrand",
  "sizes": ["300x250", "728x90"],
  "locales": ["es-CR", "en-US"]
}

→ 202 { "id": "job_test_…", "status": "queued" }
Testsleutels verbruiken geen credits.

Maak banners vanuit je code

Een verzoek met de prompt, de formaten en de talen levert een taak op die een concept maakt in al die formaten; je raadpleegt hem tot hij klaar is.

Ondertekende meldingen

Registreer een webhook en ontvang een gebeurtenis (banner gegenereerd, export klaar, goedkeuring gegeven…) met een handtekening die je kunt verifiëren.

Veilig om te testen

Testsleutels geven altijd een voorbeeldbanner terug, zonder AI of credits te gebruiken. Als je een verzoek opnieuw verstuurt met dezelfde idempotentiesleutel, wordt het niet tweemaal aangerekend.

Hoe je het gebruikt

Van de sleutel naar de banner, in drie stappen.

  1. Je maakt een sleutel

    Een testsleutel (bm_test_…) om te beginnen, of een productiesleutel (bm_live_…). Die wordt één keer volledig getoond.

  2. Je doet het verzoek

    Je stuurt de prompt, de formaten en de talen, met een idempotentie-header.

  3. Je wacht op de melding

    Je raadpleegt de taak of ontvangt de webhook zodra de banner klaar is.

Belangrijke gegevens

Kosten, limieten en vereisten.

Beschikbaar in
Abonnementen Team, Agency en Enterprise.
Sleutels
Productie en test; er wordt alleen een vingerafdruk opgeslagen, niet de waarde.
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.

Gerelateerde functies

ExporterenVraag de export vanuit je code.Bekijk BeveiligingSleutels, rechten en registratie van elke actie.Bekijk Team en rollenWie sleutels en webhooks kan aanmaken.Bekijk

Leer het stap voor stap gebruiken

Een banner maken met de APITutorialMeldingen ontvangen met webhooksTutorial

Voorbeelden van banners met deze functie

Nébula · financiën
Marejada · reizen
Pulso · sport

Vragen over api en webhooks

In welke abonnementen zit de API?

In Team ($99 per maand), Agency ($299 per maand) en Enterprise (vanaf $1.500 per maand). Starter bevat geen API of webhooks.

Gebruik ik credits bij het testen?

Niet met testsleutels: die geven altijd een voorbeeldbanner, zonder AI of credits. Productiesleutels gebruiken dezelfde credits als de app.

Wat gebeurt er als ik een verzoek opnieuw stuur?

Met de Idempotency-Key-header geeft een herhaald verzoek het vorige resultaat terug in plaats van opnieuw te rekenen.

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.

Verbind BannerMotion met je platform.

Probeer het met een echte campagne.

Mijn eerste campagne makenPraat met sales