Partner-API voor koppelingen

De Partner-API laat een extern systeem (bijvoorbeeld een koppeling met je eigen website, of een tool van een externe partner) via een beveiligde sleutel jullie kampen ophalen en er rechtstreeks inschrijvingen op doen. Dit is enkel relevant als je zo'n koppeling wil opzetten — de meeste organisaties hebben dit niet nodig.

Dit is een technische functionaliteit. Meestal richt een ontwikkelaar (van jullie zelf of van de externe partij) de koppeling in met behulp van de sleutel en documentatie hieronder.

---

De API-instellingen openen

Ga naar Instellingen → API. Bovenaan zie je of er al een actieve API-key is, en wanneer die is aangemaakt.

---

Een API-key genereren

Klik op Genereer API key. De sleutel wordt getoond en kan je kopiëren — bewaar ze meteen ergens veilig, want om veiligheidsredenen wordt ze nadien nergens meer volledig getoond. Geef deze sleutel enkel door aan wie de koppeling effectief bouwt.

---

Een API-key regenereren of intrekken

• Regenereren maakt een nieuwe sleutel aan en maakt de vorige sleutel onmiddellijk ongeldig. Elke koppeling die nog de oude sleutel gebruikt, stopt dan met werken tot ze bijgewerkt is met de nieuwe sleutel.
• Intrekken schakelt de Partner-API meteen volledig uit: er is dan geen geldige sleutel meer en alle koppelingen die erop steunen, stoppen met werken.

Gebruik regenereren of intrekken bijvoorbeeld als een sleutel per ongeluk gelekt is, of als je een koppeling met een externe partij stopzet.

---

Technische documentatie

Onderaan hetzelfde tabblad (Instellingen → API) vind je de volledige technische documentatie voor wie de koppeling bouwt: hoe je de sleutel meestuurt, welke gegevens je kan ophalen en hoe je een inschrijving aanmaakt, inclusief voorbeeldcode. Verwijs de ontwikkelaar van de koppeling naar dat tabblad.

Beschikbare endpoints

• GET /api/v1/camps — lijst van al je kampen.
• GET /api/v1/camps/:campId — details van één kamp, inclusief de velden van het inschrijvingsformulier (formFields). Is het kamp met een wachtwoord vergrendeld, geef dan ?password=... mee — zonder het juiste wachtwoord krijg je enkel locked: true terug, zonder verdere details.
• POST /api/v1/camps/:campId/registrations — maakt een inschrijving aan. Verwacht values (de antwoorden op het inschrijvingsformulier) en optioneel selectedExtraIds, discountCode, payFullAmount en password. Geeft een registrationId terug en, bij een online betaling, een betaal-URL.

Limieten en foutmeldingen

Elke API-key mag maximaal 60 aanvragen per minuut doen; daarboven krijg je een 429-fout. Andere mogelijke foutcodes: 401 (geen of ongeldige sleutel), 403 (sleutel geeft geen toegang tot dit kamp) en 404 (kamp of inschrijving niet gevonden).