Webhook d'inscription

POST/api/webhooks/signup/:contestId

Webhook Secret

Recevez les événements d'inscription de votre application ou de services tiers pour créer automatiquement des participations au concours.

Point de terminaison

text

POST https://blitzrocket.com/api/webhooks/signup/:contestId

Paramètres de chemin

contestIdstring required

L'identifiant unique du concours

Corps de la requête

emailstring required

Adresse email de la nouvelle inscription

namestring

Nom de la nouvelle inscription (optionnel)

phonestring

Numéro de téléphone (optionnel)

referralCodestring

Code de parrainage si l'inscription a été référée (optionnel)

Requête

bash

curl -X POST https://blitzrocket.com/api/webhooks/signup/clx1abc123 \
  -H "Content-Type: application/json" \
  -d '{
    "email": "newuser@example.com",
    "name": "New User"
  }'

javascript

const contestId = "clx1abc123";
const response = await fetch(
  `https://blitzrocket.com/api/webhooks/signup/${contestId}`,
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      email: "newuser@example.com",
      name: "New User",
    }),
  }
);

const data = await response.json();
console.log(data);

python

import requests

contest_id = "clx1abc123"
response = requests.post(
    f"https://blitzrocket.com/api/webhooks/signup/{contest_id}",
    json={
        "email": "newuser@example.com",
        "name": "New User"
    }
)

data = response.json()
print(data)

Réponse

json

{
  "success": true,
  "data": {
    "entryId": "entry_new789",
    "email": "newuser@example.com",
    "alreadyExists": false,
    "isReferred": false,
    "pointsAwarded": {
      "advocate": 0,
      "friend": 0
    }
  }
}

Guide d'installation

Rendez-vous sur la page Design de votre concours dans le tableau de bord Blitz Rocket
Activez le Suivi externe dans les paramètres du concours
Copiez votre URL de webhook : https://blitzrocket.com/api/webhooks/signup/{your-contest-id}
Configurez votre plateforme externe pour envoyer des requêtes POST à cette URL lors des événements d'inscription

Exemples d'intégration

Création de client Shopify

Configurez un webhook Shopify pour se déclencher sur customers/create :

javascript

// Shopify envoie automatiquement cette charge utile :
{
  "email": "customer@example.com",
  "first_name": "Jane",
  "last_name": "Doe"
}

Formulaire d'inscription personnalisé

javascript

document.querySelector("#signup-form").addEventListener("submit", async (e) => {
  e.preventDefault();

  const form = new FormData(e.target);
  const email = form.get("email");
  const name = form.get("name");

  // D'abord, enregistrez dans votre système
  await registerUser({ email, name });

  // Puis, créez la participation au concours via webhook
  await fetch(
    `https://blitzrocket.com/api/webhooks/signup/${CONTEST_ID}`,
    {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ email, name }),
    }
  );
});