API Documentatie

Integreer uw externe systemen met SevenDeuce

Event Inschrijving API

Externe systemen kunnen via deze API inschrijvingen aanmaken voor poker events.

Endpoint

POST

https://sevendeuce.be/api/functions/createSubscriptionAPI

Authenticatie

Voeg een API key toe aan de request header:

x-api-key: uw_api_key_hier

Request Body

JSON object met de volgende velden:

event_id

verplicht

String - ID van het event waarvoor de speler zich inschrijft

player_name

verplicht

String - Naam van de speler

player_email

verplicht

String - Email adres van de speler

player_phone

verplicht

String - Telefoonnummer van de speler

notes

optioneel

String - Eventuele opmerkingen bij de inschrijving

Voorbeeld Request

curl -X POST https://sevendeuce.be/api/functions/createSubscriptionAPI \
  -H "Content-Type: application/json" \
  -H "x-api-key: uw_api_key_hier" \
  -d '{
    "event_id": "abc123",
    "player_name": "Jan Janssen",
    "player_email": "jan@example.com",
    "player_phone": "+32 123 45 67 89",
    "notes": "Eerste keer"
  }'

Response Voorbeelden

✓ Succes (201 Created)

{
  "success": true,
  "message": "Subscription created successfully",
  "subscription": {
    "id": "xyz789",
    "event_id": "abc123",
    "player_name": "Jan Janssen",
    "player_email": "jan@example.com",
    "created_date": "2026-02-03T10:30:00Z"
  }
}

✗ Fout - Ontbrekende velden (400 Bad Request)

{
  "success": false,
  "error": "Missing required fields: event_id, player_name, player_email, player_phone"
}

✗ Fout - Ongeldige API key (401 Unauthorized)

{
  "success": false,
  "error": "Unauthorized. Invalid or missing API key."
}

✗ Fout - Event niet gevonden (404 Not Found)

{
  "success": false,
  "error": "Event with ID abc123 not found"
}

⚠ Fout - Dubbele inschrijving (409 Conflict)

{
  "success": false,
  "error": "Player is already subscribed to this event",
  "subscription_id": "existing123"
}

⚠️ Belangrijk

• De API key moet veilig bewaard worden en mag niet publiek gedeeld worden

• Event ID's kun je ophalen via de Kalender pagina of admin panel

• Email adressen worden automatisch gecontroleerd op duplicaten per event

• Alle inschrijvingen via deze API krijgen automatisch registration_source: "external"