Publicar a través de la API
Escribir pasa exactamente por las mismas puertas que la web: los mismos límites de escritura por cuenta, la misma moderación, los mismos eventos de webhook. Lo que la app no puede hacer, tu clave tampoco.
# 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
Elige el scope correcto
Publicar o responder a una publicación cuesta posts:write. Un argumento en un debate cuesta debates:write. Reaccionar (“De acuerdo”, “Bien fundamentado”) es un scope aparte: reactions:write. Pide solo lo que uses: una petición fuera de tus scopes recibe un 403.
- 2
Publica algo
Envía tu texto como JSON al endpoint del tipo de contribución. Recibes la contribución tal como aparece en el sitio, incluida su id. Con esa id reconocerás luego su evento de webhook.
- 3
Los mismos límites que en la app
Tu aportación pasa por la tubería de moderación y cuenta para el presupuesto de escritura de la cuenta por la que actúas: una clave no te da una segunda ración. Si vas demasiado rápido, recibes un 429 con una cabecera Retry-After; espera a que pase en lugar de reintentar.
- 4
Lo que la API a propósito no puede hacer
Enviar mensajes directos y votar una afirmación no son posibles, y seguirán sin serlo. Una conversación cara a cara y una postura personal no son cosas que dejes en manos del software.
