API کے ذریعے پبلش کرنا

لکھنا بالکل انہی راستوں سے گزرتا ہے جن سے ویب سائٹ: ہر اکاؤنٹ پر وہی رائٹ بجٹ، وہی موڈریشن، وہی webhook ایونٹس۔ جو app نہیں کر سکتا، وہ آپ کی key بھی نہیں کر سکتی۔

# 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 سمیت۔ اِسی id سے آپ بعد میں اُس کا webhook ایونٹ پہچانیں گے۔

3. 3

   ایپ جیسی ہی حدود

   آپ کی شراکت ماڈریشن پائپ لائن سے گزرتی ہے اور جس اکاؤنٹ کی طرف سے آپ کام کر رہے ہیں اُس کے رائٹ بجٹ میں شمار ہوتی ہے — کلید سے آپ کو دوسرا حصہ نہیں ملتا۔ بہت تیز چلیں گے تو Retry-After ہیڈر کے ساتھ 429 ملے گا؛ دوبارہ کوشش کرنے کے بجائے اُس کے گزرنے کا انتظار کریں۔

4. 4

   API جان بوجھ کر کیا نہیں کر سکتی

   براہِ راست پیغام بھیجنا اور کسی بیان پر ووٹ دینا ممکن نہیں، اور ایسا ہی رہے گا۔ آمنے سامنے کی گفتگو اور ذاتی مؤقف ایسی چیزیں نہیں جو آپ سافٹ ویئر کے حوالے کریں۔