Blitz Rocket API Documentatie

Introductie

De Blitz Rocket API stelt je in staat om wedstrijden, inzendingen, bonusacties en verwijzingsregistratie programmatisch te beheren. Gebruik de REST API om het wedstrijdplatform van Blitz Rocket te integreren in je bestaande applicaties, workflows te automatiseren en aangepaste ervaringen te bouwen.

Basis URL

Alle API-aanvragen moeten worden gedaan naar:

https://blitzrocket.com/api/v1

Wat je kunt doen

• Wedstrijden — Lijst en haal wedstrijddetails, analyses en ranglijsten op
• Inzendingen — Maak aan, werk bij, diskwalificeer inzendingen en beheer deelnemerspunten
• Bonusacties — Haal bonusacties op en voltooi deze voor wedstrijdinzendingen
• Aankopen — Registreer en volg aankopen gekoppeld aan wedstrijdinzendingen
• Ranglijst — Haal gerangschikte ranglijsten op voor elke wedstrijd
• Analyse — Haal prestatiegegevens van wedstrijden op
• Webhooks — Ontvang realtime meldingen voor aanmeldingen en aankopen
• Verwijzingsregistratie — Volg bezoeken, aanmeldingen en aankopen via verwijzingslinks

Snel aan de slag

1. Krijg je API-sleutel — Ga naar je teaminstellingen in het Blitz Rocket dashboard en maak een API-sleutel aan
2. Kies je sleuteltype — Gebruik een publieke sleutel voor alleen-lezen toegang of een privésleutel voor volledige lees-/schrijftoegang
3. Doe je eerste aanvraag — Probeer je wedstrijden op te sommen:

curl -X GET https://blitzrocket.com/api/v1/contests \
  -H "x-api-key: your_api_key_here"

const response = await fetch("https://blitzrocket.com/api/v1/contests", {
  headers: {
    "x-api-key": "your_api_key_here",
  },
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    "https://blitzrocket.com/api/v1/contests",
    headers={"x-api-key": "your_api_key_here"}
)
data = response.json()
print(data)

Responsformaat

Alle API-responses volgen een consistent formaat:

Succesvolle respons:

{
  "success": true,
  "data": { ... }
}

Foutrespons:

{
  "success": false,
  "error": "Een beschrijving van wat er misging"
}

Volgende stappen

• Authenticatie — Leer over API-sleuteltypes en authenticatiemethoden
• Verzoeklimieten — Begrijp de limieten voor aanvragen
• API Referentie — Verken alle beschikbare eindpunten