Passo a passo

Publicar pela API

Escrever passa exatamente pelas mesmas portas que o site: os mesmos limites de escrita por conta, a mesma moderação, os mesmos eventos de webhook. O que o app não pode fazer, sua chave também não pode.

# 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
Escolha o scope certo
Publicar ou responder a uma publicação custa posts:write. Um argumento em um debate custa debates:write. Reagir (“Concordo”, “Bem fundamentado”) é um scope à parte: reactions:write. Peça só o que você usa — uma requisição fora dos seus scopes recebe um 403.
2
Publique algo
Envie seu texto como JSON para o endpoint do tipo de contribuição. Você recebe a contribuição de volta exatamente como ela aparece no site, incluindo o id dela. É por esse id que você vai reconhecer o evento de webhook depois.
3
Os mesmos limites do app
Sua contribuição passa pelo pipeline de moderação e conta no orçamento de escrita da conta pela qual você age — uma chave não te dá uma segunda porção. Se for rápido demais, você recebe um 429 com um cabeçalho Retry-After; espere passar em vez de tentar de novo.
4
O que a API deliberadamente não pode fazer
Enviar mensagens diretas e votar em uma afirmação não são possíveis, e vão continuar assim. Uma conversa a sós e uma posição pessoal não são coisas que você entrega a um software.

Ir para a referência →

Publicar pela 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.

Escolha o scope certo

Publicar ou responder a uma publicação custa posts:write. Um argumento em um debate custa debates:write. Reagir (“Concordo”, “Bem fundamentado”) é um scope à parte: reactions:write. Peça só o que você usa — uma requisição fora dos seus scopes recebe um 403.

Publique algo

Envie seu texto como JSON para o endpoint do tipo de contribuição. Você recebe a contribuição de volta exatamente como ela aparece no site, incluindo o id dela. É por esse id que você vai reconhecer o evento de webhook depois.

Os mesmos limites do app

Sua contribuição passa pelo pipeline de moderação e conta no orçamento de escrita da conta pela qual você age — uma chave não te dá uma segunda porção. Se for rápido demais, você recebe um 429 com um cabeçalho Retry-After; espere passar em vez de tentar de novo.

O que a API deliberadamente não pode fazer

Enviar mensagens diretas e votar em uma afirmação não são possíveis, e vão continuar assim. Uma conversa a sós e uma posição pessoal não são coisas que você entrega a um software.