Naar de inhoud

Overzicht

Wat de Partners API doet en hoe je je eerste aanvraag stuurt.

Updated Bekijk als markdown

Met de Partners API maakt een goedgekeurde partner boekingen en contacten aan in het WaW-account van een klant, en werkt ze bij. Jouw systeem stuurt de gegevens, en ze verschijnen meteen in het WaW-team van de klant.

De API schrijft alleen. Er zijn vier routes:

Methode Pad Wat het doet
POST /v1/bookings Een boeking aanmaken
PATCH /v1/bookings/{id} Een boeking bijwerken
POST /v1/contacts Een contact aanmaken
PATCH /v1/contacts/{id} Een contact bijwerken

Basis-URL’s

Omgeving Basis-URL
Productie https://api.withoutaworry.com
Acceptatie https://acc-api.withoutaworry.com

Plak het pad van de route achter de basis-URL, bijvoorbeeld https://api.withoutaworry.com/v1/bookings.

Voor je begint

Je hebt een klantsleutel nodig voor elke WaW-klant waarmee je werkt. WaW geeft de sleutel uit nadat de klant de koppeling heeft goedgekeurd. Neem contact op met WaW om er een in te stellen. Lees Authenticatie voor het gebruik ervan.

Bouw je een koppeling voor veel klanten? Begin bij WaW integreren in je platform.

Je eerste aanvraag

Maak een contact aan, en daarna een boeking voor dat contact.

curl https://api.withoutaworry.com/v1/contacts \
  -H "Authorization: Bearer $WAW_CUSTOMER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "person-8421",
    "first_name": "Noor",
    "last_name": "Janssens",
    "email": "noor@example.com"
  }'

Het antwoord bevat de WaW-ID van het nieuwe contact:

{ "id": "7b0c2f4e-1d2a-4c6b-9e8f-3a5d6c7b8e9f", "external_id": "person-8421" }

Geef die ID mee als contact_id wanneer je de boeking aanmaakt:

curl https://api.withoutaworry.com/v1/bookings \
  -H "Authorization: Bearer $WAW_CUSTOMER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "booking-8421",
    "name": "Huwelijk Noor en Sam",
    "start_date": "2027-06-12T16:00:00+02:00",
    "end_date": "2027-06-13T02:00:00+02:00",
    "location": "Gent",
    "contact_id": "7b0c2f4e-1d2a-4c6b-9e8f-3a5d6c7b8e9f",
    "status": "confirmed"
  }'

Bewaar beide WaW-ID’s aan jouw kant. Je hebt ze nodig om de records later bij te werken.

Interactieve referentie

De volledige OpenAPI-beschrijving is beschikbaar als interactieve referentie en als ruwe JSON. Die referentie is in het Engels.

Navigatie

Type to search…

↑↓ navigate↵ selectEsc close