Stapsgewijs

Publiceren via de API

Schrijven gaat door precies dezelfde poorten als de website: dezelfde schrijflimieten per account, dezelfde moderatie, dezelfde webhook-events. Wat de app niet mag, mag je sleutel ook niet.

# een bubbel plaatsen (scope: posts:write)
curl -X POST https://api.debaty.com/v1/posts \
  -H "Authorization: Bearer dbty_live_sk_JOUW_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"body": "Wat kost rekeningrijden een gemiddeld huishouden?"}'

# erop reageren (scope: posts:write)
curl -X POST https://api.debaty.com/v1/posts/POST_ID/comments \
  -H "Authorization: Bearer dbty_live_sk_JOUW_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"body": "Volgens het CPB rond de 240 euro per jaar."}'

# een waardering plaatsen (scope: reactions:write)
curl -X POST https://api.debaty.com/v1/posts/POST_ID/reactions \
  -H "Authorization: Bearer dbty_live_sk_JOUW_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"kind": "well_sourced"}'

# 429? Wacht het aantal seconden uit de Retry-After-header af.
# 403? Dan mist je sleutel de scope — of hebben wij hem tijdelijk
#      dichtgezet; de reden staat dan in het antwoord.

1
Kies de juiste scope
Een bubbel plaatsen of erop reageren kost posts:write. Een argument in een debat kost debates:write. Waarderen (“Mee eens”, “Goed onderbouwd”) is een aparte scope: reactions:write. Vraag alleen wat je gebruikt — een verzoek buiten je scopes geeft een 403.
2
Plaats iets
Stuur je tekst als JSON naar het endpoint van de soort bijdrage. Je krijgt de bijdrage terug zoals hij op de site staat, inclusief zijn id. Dat id is waar je later je webhook-event aan herkent.
3
Dezelfde grenzen als in de app
Je bijdrage gaat door de moderatiepijplijn en telt mee voor het schrijfbudget van het account waarvoor je handelt — via een sleutel krijg je geen tweede portie. Ben je te snel, dan volgt een 429 met een Retry-After-header; wacht die af in plaats van opnieuw te proberen.
4
Wat je niet via de API doet
Privéberichten sturen en stemmen op een stelling kunnen niet, en dat blijft zo. Een gesprek onder vier ogen en een persoonlijk standpunt zijn geen dingen die je uitbesteedt aan software.

Naar de referentie →

Schrijven gaat door precies dezelfde poorten als de website: dezelfde schrijflimieten per account, dezelfde moderatie, dezelfde webhook-events. Wat de app niet mag, mag je sleutel ook niet.

# een bubbel plaatsen (scope: posts:write) curl -X POST https://api.debaty.com/v1/posts \ -H "Authorization: Bearer dbty_live_sk_JOUW_SLEUTEL" \ -H "Content-Type: application/json" \ -d '{"body": "Wat kost rekeningrijden een gemiddeld huishouden?"}' # erop reageren (scope: posts:write) curl -X POST https://api.debaty.com/v1/posts/POST_ID/comments \ -H "Authorization: Bearer dbty_live_sk_JOUW_SLEUTEL" \ -H "Content-Type: application/json" \ -d '{"body": "Volgens het CPB rond de 240 euro per jaar."}' # een waardering plaatsen (scope: reactions:write) curl -X POST https://api.debaty.com/v1/posts/POST_ID/reactions \ -H "Authorization: Bearer dbty_live_sk_JOUW_SLEUTEL" \ -H "Content-Type: application/json" \ -d '{"kind": "well_sourced"}' # 429? Wacht het aantal seconden uit de Retry-After-header af. # 403? Dan mist je sleutel de scope — of hebben wij hem tijdelijk # dichtgezet; de reden staat dan in het antwoord.

Kies de juiste scope

Een bubbel plaatsen of erop reageren kost posts:write. Een argument in een debat kost debates:write. Waarderen (“Mee eens”, “Goed onderbouwd”) is een aparte scope: reactions:write. Vraag alleen wat je gebruikt — een verzoek buiten je scopes geeft een 403.

Plaats iets

Stuur je tekst als JSON naar het endpoint van de soort bijdrage. Je krijgt de bijdrage terug zoals hij op de site staat, inclusief zijn id. Dat id is waar je later je webhook-event aan herkent.

Dezelfde grenzen als in de app

Je bijdrage gaat door de moderatiepijplijn en telt mee voor het schrijfbudget van het account waarvoor je handelt — via een sleutel krijg je geen tweede portie. Ben je te snel, dan volgt een 429 met een Retry-After-header; wacht die af in plaats van opnieuw te proberen.

Wat je niet via de API doet

Privéberichten sturen en stemmen op een stelling kunnen niet, en dat blijft zo. Een gesprek onder vier ogen en een persoonlijk standpunt zijn geen dingen die je uitbesteedt aan software.