Stap foar stap

Publisearje fia de API

Skriuwe giet troch krekt deselde poarten as de webside: deselde skriuwlimiten de akkount, deselde moderaasje, deselde webhook-eveneminten. Wat de app net mei, mei dyn kaai ek net.

# 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 goede scope
In berjocht pleatse of derop reagearje kostet posts:write. In argumint yn in debat kostet debates:write. Wurdearje („Iens“, „Goed ûnderboud“) is in aparte scope: reactions:write. Freegje allinne wat do brûkst — in fersyk bûten dyn scopes jout in 403.
2
Pleats wat
Stjoer dyn tekst as JSON nei it endpoint fan dy soarte bydrage. Do krijst de bydrage werom sa't er op de side stiet, ynklusyf syn id. Oan dat id werkenst do letter syn webhook-event.
3
Deselde grinzen as yn de app
Dyn bydrage giet troch de moderaasjepipeline en telt mei foar it skriuwbudzjet fan it akkount dêr'tsto foar hannelest — mei in kaai krigest gjin twadde porsje. Giest te hurd, dan folget in 429 mei in Retry-After-header; wachtsje dy ôf ynstee fan opnij te besykjen.
4
Wat de API mei sin net dwaan kin
Privéberjochten stjoere en op in stelling stimme kinne net, en dat bliuwt sa. In petear ûnder fjouwer eagen en in persoanlik stânpunt binne gjin dingen dy'tsto útbestegest oan software.

Nei de referinsje →

Skriuwe giet troch krekt deselde poarten as de webside: deselde skriuwlimiten de akkount, deselde moderaasje, deselde webhook-eveneminten. Wat de app net mei, mei dyn kaai ek net.

# 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 goede scope

In berjocht pleatse of derop reagearje kostet posts:write. In argumint yn in debat kostet debates:write. Wurdearje („Iens“, „Goed ûnderboud“) is in aparte scope: reactions:write. Freegje allinne wat do brûkst — in fersyk bûten dyn scopes jout in 403.

Pleats wat

Stjoer dyn tekst as JSON nei it endpoint fan dy soarte bydrage. Do krijst de bydrage werom sa't er op de side stiet, ynklusyf syn id. Oan dat id werkenst do letter syn webhook-event.

Deselde grinzen as yn de app

Dyn bydrage giet troch de moderaasjepipeline en telt mei foar it skriuwbudzjet fan it akkount dêr'tsto foar hannelest — mei in kaai krigest gjin twadde porsje. Giest te hurd, dan folget in 429 mei in Retry-After-header; wachtsje dy ôf ynstee fan opnij te besykjen.

Wat de API mei sin net dwaan kin

Privéberjochten stjoere en op in stelling stimme kinne net, en dat bliuwt sa. In petear ûnder fjouwer eagen en in persoanlik stânpunt binne gjin dingen dy'tsto útbestegest oan software.