Langkah demi langkah

Menerbitkan lewat API

Menulis lewat gerbang yang persis sama dengan situs web: batas tulis per akun yang sama, moderasi yang sama, event webhook yang sama. Apa yang tidak boleh dilakukan app, key kamu juga tidak boleh.

# 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
Pilih scope yang tepat
Memposting atau membalas sebuah postingan memakai posts:write. Sebuah argumen dalam debat memakai debates:write. Memberi reaksi (“Setuju”, “Bersumber baik”) adalah scope terpisah: reactions:write. Minta hanya yang kamu pakai — permintaan di luar scope-mu akan mendapat 403.
2
Terbitkan sesuatu
Kirim teksmu sebagai JSON ke endpoint untuk jenis kontribusi itu. Kamu mendapatkan kontribusi itu kembali persis seperti yang tampil di situs, termasuk id-nya. Lewat id itulah nanti kamu mengenali event webhook-nya.
3
Batasan yang sama seperti di aplikasi
Kontribusimu melewati pipeline moderasi dan dihitung ke anggaran tulis akun yang kamu wakili — kunci tidak memberimu jatah kedua. Kalau terlalu cepat, kamu dapat 429 dengan header Retry-After; tunggu sampai lewat daripada mencoba lagi.
4
Hal yang sengaja tidak bisa dilakukan API
Mengirim pesan langsung dan memberi suara pada sebuah pernyataan tidak bisa, dan akan tetap begitu. Percakapan empat mata dan pendirian pribadi bukan hal yang kamu serahkan ke perangkat lunak.

Ke referensi →

Menulis lewat gerbang yang persis sama dengan situs web: batas tulis per akun yang sama, moderasi yang sama, event webhook yang sama. Apa yang tidak boleh dilakukan app, key kamu juga tidak boleh.

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

Pilih scope yang tepat

Memposting atau membalas sebuah postingan memakai posts:write. Sebuah argumen dalam debat memakai debates:write. Memberi reaksi (“Setuju”, “Bersumber baik”) adalah scope terpisah: reactions:write. Minta hanya yang kamu pakai — permintaan di luar scope-mu akan mendapat 403.

Terbitkan sesuatu

Kirim teksmu sebagai JSON ke endpoint untuk jenis kontribusi itu. Kamu mendapatkan kontribusi itu kembali persis seperti yang tampil di situs, termasuk id-nya. Lewat id itulah nanti kamu mengenali event webhook-nya.

Batasan yang sama seperti di aplikasi

Kontribusimu melewati pipeline moderasi dan dihitung ke anggaran tulis akun yang kamu wakili — kunci tidak memberimu jatah kedua. Kalau terlalu cepat, kamu dapat 429 dengan header Retry-After; tunggu sampai lewat daripada mencoba lagi.

Hal yang sengaja tidak bisa dilakukan API

Mengirim pesan langsung dan memberi suara pada sebuah pernyataan tidak bisa, dan akan tetap begitu. Percakapan empat mata dan pendirian pribadi bukan hal yang kamu serahkan ke perangkat lunak.