Voor ontwikkelaars
Kippenhelden biedt een interface (API) waarmee partnerplatforms de inzamelingen van hun gebruikers automatisch overdragen. Sigarettenpeuken die bij een actie op jullie platform zijn geteld, verschijnen dan ook op Kippenhelden, zonder dat iemand ze dubbel hoeft in te voeren.
Wat de API kan
- inzamelingen aanmaken en bijwerken: datum, plaats, aantal sigarettenpeuken en personen, titel en beschrijving
- de foto van een inzameling instellen, vervangen of intrekken
- een overgedragen inzameling intrekken, bijvoorbeeld als het record bij jullie is verwijderd
Zo koppelen gebruikers hun account
Elke overgedragen inzameling hoort bij een Kippenhelden-account. De persoon maakt daarvoor onder „Mijn omgeving” → „Instellingen” → „Gekoppelde diensten” een token voor jullie platform aan, kiest zo nodig een team en slaat de token bij jullie op. Die kan hij of zij op elk moment intrekken.
Partner worden
De API staat open voor goedgekeurde partners. Schrijf ons op … met naam en website van jullie platform, welke gegevens jullie willen overdragen en of jullie foto's willen sturen.
Voorbeeld
Een inzameling aanmaken of bijwerken:
curl -X PUT https://kippenhelden.de/api/v1/collections/d4984ccb-b71e-47c4 \
-H "Authorization: Bearer khu_…" \
-H "Content-Type: application/json" \
-d '{
"date": "2026-10-24",
"count": 1840,
"people": 12,
"country": "DE",
"zip": "10119",
"title": "Cleanup am Arkonaplatz",
"description": "Zwei Stunden rund um den Arkonaplatz, vor allem an Bushaltestellen und Baumscheiben.",
"updated_at": "2026-10-24T13:05:00+02:00"
}'
Specificatie
Alle endpoints, velden, grenswaarden en foutcodes staan in de OpenAPI-specificatie (Engelstalig). Jullie kunnen die in elk OpenAPI-hulpmiddel laden en er een client mee genereren.