Geavanceerde API-gebruik

Documentatie

Geavanceerde API-gebruik

Geavanceerde API-gebruik

Batchverwerking

Voer meerdere operaties uit in één verzoek met de batch-API:

POST /api/v1/batch HTTP/1.1
Content-Type: application/json

{
    "requests": [
        {
            "method": "GET",
            "url": "/api/v1/woometadatas/1"
        },
        {
            "method": "POST",
            "url": "/api/v1/woometadatas",
            "body": {
                "name": "nieuw_veld",
                "value": "nieuwe_waarde"
            }
        }
    ]
}

Webhooks instellen

Ontvang realtime updates voor gebeurtenissen in het systeem:

  1. Maak een webhook aan in je accountinstellingen
  2. Kies gebeurtenissen waarop je geabonneerd wilt zijn
  3. Geef een callback-URL op waar de meldingen naartoe moeten
  4. Bevestig je webhook door de verificatie-uitdaging te voltooien

Voorbeeld webhook payload:

{
    "event": "woometadata.created",
    "data": {
        "id": 123,
        "name": "nieuw_veld",
        "value": "nieuwe_waarde"
    },
    "created_at": "2025-01-01T12:00:00Z"
}

Voorbeeld cURL commando:

curl -X GET \
  https://jouwdomein.nl/api/v1/woometadatas \
  -H "X-User-Email: [email protected]" \
  -H "X-Api-Token: jouw-api-sleutel"