KoppelingenAPI
Eén aanroep na de afspraak of de bestelling, en Citypicked vraagt om de review. Beoordelingen en privéfeedback komen terug als webhooks.
Aanvraag
POST /v1/requests Authorization: Bearer cp_live_… Idempotency-Key: booking-4711 { "channel": "sms", "consent": true, "contacts": [{ "name": "Sanne Visser", "phone": "+12015550123" }] }
Antwoord 201
{ "created": 1,
"results": [{ "outcome": "created", "request_id": "…" }] }Webhooks
Meld een URL aan voor de events die je nodig hebt. Elke levering is ondertekend en komt binnen enkele seconden aan.
Handtekening controleren
Citypicked-Signature: t=1762594200,v1=5f2c… const expected = crypto .createHmac("sha256", secret) .update(`${t}.${rawBody}`) .digest("hex");
Antwoordt je URL niet met een 2xx, dan proberen we het nog zes keer, verspreid over ongeveer 18 uur.
Endpoints
Lezen werkt met elke sleutel. Voor versturen heb je een sleutel met de scope send nodig.
Voor de eerste aanroep
Niets extra. Lezen kan in elk abonnement, versturen via de API vanaf Pro. Sms'en kosten credits, net als in de app, e-mails niet.
Ja. Met send_at plan je tot 30 dagen vooruit in. Tot dan annuleert één aanroep het, bijvoorbeeld als een afspraak niet doorgaat.
Nee. Je kunt verzoeken en feedback ook ophalen, met since alleen wat nieuw is. Met webhooks hoef je niet steeds zelf op te vragen, en ze komen meteen binnen.
Met channel op whatsapp krijg je een link terug. Het team opent die op de eigen telefoon en verstuurt het bericht zelf, net als in de app.
Ja, de OpenAPI 3.1-beschrijving van elk endpoint, op te halen zonder sleutel.
Je eerste verzoek gaat binnen vijf minuten de deur uit.