Pas à pas

Publier via l'API

L'écriture passe exactement par les mêmes portes que le site : les mêmes quotas d'écriture par compte, la même modération, les mêmes événements webhook. Ce que l'app ne peut pas faire, ta clé ne le peut pas non plus.

# 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
Choisis le bon scope
Publier un contenu ou y répondre coûte posts:write. Un argument dans un débat coûte debates:write. Réagir (« D'accord », « Bien sourcé ») est un scope distinct : reactions:write. Ne demande que ce que tu utilises — une requête hors de tes scopes reçoit un 403.
2
Publie quelque chose
Envoie ton texte au format JSON vers l'endpoint du type de contribution. Tu récupères la contribution telle qu'elle apparaît sur le site, y compris son id. C'est grâce à cet id que tu reconnaîtras plus tard son événement webhook.
3
Les mêmes limites que dans l'appli
Ta contribution passe par le pipeline de modération et compte dans le budget d'écriture du compte pour lequel tu agis — une clé ne t'offre pas une seconde part. Si tu vas trop vite, tu reçois un 429 avec un en-tête Retry-After ; attends qu'il passe plutôt que de réessayer.
4
Ce que l'API ne peut délibérément pas faire
Envoyer des messages privés et voter sur une affirmation ne sont pas possibles, et ça restera ainsi. Une conversation en tête-à-tête et une position personnelle ne sont pas des choses que tu confies à un logiciel.

Vers la référence →

Publier via l'API

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

Choisis le bon scope

Publier un contenu ou y répondre coûte posts:write. Un argument dans un débat coûte debates:write. Réagir (« D'accord », « Bien sourcé ») est un scope distinct : reactions:write. Ne demande que ce que tu utilises — une requête hors de tes scopes reçoit un 403.

Publie quelque chose

Envoie ton texte au format JSON vers l'endpoint du type de contribution. Tu récupères la contribution telle qu'elle apparaît sur le site, y compris son id. C'est grâce à cet id que tu reconnaîtras plus tard son événement webhook.

Les mêmes limites que dans l'appli

Ta contribution passe par le pipeline de modération et compte dans le budget d'écriture du compte pour lequel tu agis — une clé ne t'offre pas une seconde part. Si tu vas trop vite, tu reçois un 429 avec un en-tête Retry-After ; attends qu'il passe plutôt que de réessayer.

Ce que l'API ne peut délibérément pas faire

Envoyer des messages privés et voter sur une affirmation ne sont pas possibles, et ça restera ainsi. Une conversation en tête-à-tête et une position personnelle ne sont pas des choses que tu confies à un logiciel.