Schritt für Schritt

Über die API veröffentlichen

Schreiben läuft durch genau dieselben Tore wie die Website: dieselben Schreib-Budgets pro Account, dieselbe Moderation, dieselben Webhook-Events. Was die App nicht darf, darf dein Schlüssel auch nicht.

# 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
Wähl den richtigen Scope
Einen Beitrag zu posten oder darauf zu antworten kostet posts:write. Ein Argument in einer Debatte kostet debates:write. Reagieren („Zustimmen“, „Gut belegt“) ist ein eigener Scope: reactions:write. Frag nur nach dem, was du nutzt – eine Anfrage außerhalb deiner Scopes bekommt einen 403.
2
Veröffentliche etwas
Schick deinen Text als JSON an den Endpoint für die jeweilige Beitragsart. Du bekommst den Beitrag genau so zurück, wie er auf der Seite erscheint, inklusive seiner id. An dieser id erkennst du später sein Webhook-Event.
3
Dieselben Grenzen wie in der App
Dein Beitrag durchläuft die Moderations-Pipeline und zählt auf das Schreibbudget des Kontos, für das du handelst — ein Schlüssel verschafft dir keine zweite Portion. Bist du zu schnell, bekommst du einen 429 mit einem Retry-After-Header; warte ihn ab, statt es erneut zu versuchen.
4
Was die API bewusst nicht kann
Direktnachrichten senden und über eine These abstimmen sind nicht möglich und bleiben es auch. Ein Gespräch unter vier Augen und ein persönlicher Standpunkt sind nichts, was du an Software abgibst.

Zur Referenz →

# 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.

Wähl den richtigen Scope

Einen Beitrag zu posten oder darauf zu antworten kostet posts:write. Ein Argument in einer Debatte kostet debates:write. Reagieren („Zustimmen“, „Gut belegt“) ist ein eigener Scope: reactions:write. Frag nur nach dem, was du nutzt – eine Anfrage außerhalb deiner Scopes bekommt einen 403.

Veröffentliche etwas

Schick deinen Text als JSON an den Endpoint für die jeweilige Beitragsart. Du bekommst den Beitrag genau so zurück, wie er auf der Seite erscheint, inklusive seiner id. An dieser id erkennst du später sein Webhook-Event.

Dieselben Grenzen wie in der App

Dein Beitrag durchläuft die Moderations-Pipeline und zählt auf das Schreibbudget des Kontos, für das du handelst — ein Schlüssel verschafft dir keine zweite Portion. Bist du zu schnell, bekommst du einen 429 mit einem Retry-After-Header; warte ihn ab, statt es erneut zu versuchen.

Was die API bewusst nicht kann

Direktnachrichten senden und über eine These abstimmen sind nicht möglich und bleiben es auch. Ein Gespräch unter vier Augen und ein persönlicher Standpunkt sind nichts, was du an Software abgibst.