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

   कुछ पब्लिश करो

   अपना टेक्स्ट उस तरह के योगदान के endpoint पर JSON के रूप में भेजो। तुम्हें वह योगदान वापस मिलता है, ठीक वैसे ही जैसे वह साइट पर दिखता है, उसकी id समेत। बाद में उसी id से तुम उसका webhook इवेंट पहचानोगे।

3. 3

   ऐप जैसी ही सीमाएँ

   तुम्हारा योगदान मॉडरेशन पाइपलाइन से गुज़रता है और जिस अकाउंट के लिए तुम काम कर रहे हो उसके राइट बजट में गिना जाता है — की से तुम्हें दूसरा हिस्सा नहीं मिलता। बहुत तेज़ चलोगे तो Retry-After हेडर के साथ 429 मिलेगा; दोबारा कोशिश करने के बजाय उसका इंतज़ार करो।

4. 4

   API जानबूझकर क्या नहीं कर सकता

   डायरेक्ट मैसेज भेजना और किसी कथन पर वोट करना मुमकिन नहीं है, और आगे भी ऐसा ही रहेगा। आमने-सामने की बातचीत और निजी पक्ष ऐसी चीज़ें नहीं हैं जो तुम सॉफ़्टवेयर के हवाले करो।