النشر عبر الـ API

الكتابة تمر عبر نفس البوابات تمامًا مثل الموقع: نفس حدود الكتابة لكل حساب، ونفس الإشراف، ونفس أحداث الـ webhook. ما لا يستطيع التطبيق فعله، لا يستطيع مفتاحك فعله أيضًا.

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

   اختر الـ scope المناسب

   نشر منشور أو الرد عليه يكلّف posts:write. طرح حجة في نقاش يكلّف debates:write. التفاعل («موافق»، «موثّق جيدًا») نطاق منفصل: reactions:write. اطلب فقط ما تستخدمه — طلب خارج نطاقاتك يُعطي 403.

2. 2

   انشر شيئًا

   أرسل نصك بصيغة JSON إلى نقطة النهاية (endpoint) الخاصة بنوع المساهمة. تستعيد المساهمة تمامًا كما تظهر على الموقع، بما في ذلك المعرّف (id) الخاص بها. بهذا المعرّف ستتعرّف لاحقًا على حدث الـ webhook الخاص بها.

3. 3

   نفس الحدود الموجودة في التطبيق

   مساهمتك تمرّ عبر خط المعالجة الإشرافي وتُحتسب على ميزانية الكتابة للحساب الذي تتصرّف نيابةً عنه — المفتاح لا يمنحك حصّة ثانية. إن أسرعت أكثر من اللازم، ستحصل على 429 مع ترويسة Retry-After؛ انتظر انقضاءها بدل إعادة المحاولة.

4. 4

   ما لا تستطيع الـ API فعله عن قصد

   إرسال الرسائل المباشرة والتصويت على طرح غير ممكنين، وسيبقى الأمر كذلك. المحادثة الثنائية والموقف الشخصي ليسا مما تُوكِله إلى برنامج.