逐步操作
通过 API 发布
写入走的通道和网站完全一样:每个账号的写入额度一样,审核一样,webhook 事件也一样。app 不能做的,你的密钥也不能做。
# 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
选对 scope
发布帖子或回复帖子需要 posts:write。在辩论中发表论点需要 debates:write。做出反应(“同意”“论据充分”)是单独的权限范围:reactions:write。只申请你会用到的权限——超出你权限范围的请求会返回 403。
- 2
发布内容
把你的文本以 JSON 格式发送到相应贡献类型的 endpoint。你会拿回这条贡献,和它在网站上显示的完全一样,包括它的 id。之后你就靠这个 id 来识别它的 webhook 事件。
- 3
和应用里一样的限制
你的内容会经过审核流程,并计入你所代表账号的写入额度——用密钥并不会给你额外的份额。速度太快就会收到带 Retry-After 头的 429;请等它过去,别急着重试。
- 4
API 故意做不到的事
发送私信和对主张投票都做不到,而且以后也一样。一对一的对话和个人立场,不是你能交给软件去做的事。
