Integratsiyalar va avtopostlash

Ilovadagi «Dasturchilar» boʻlimi — integratsiyalar uchun kirish nuqtasi. Bu yerda sen ommaviy REST API v1 bilan ishlash uchun API-kalitlar yaratasan, postlar haqidagi hodisalarni oʻz serveringga olish uchun webhooklarni sozlaysan va RSSdan avtopostlashni ulaysan — lentangdagi yangi maqolalar avtomatik ravishda postlarga aylanadi.

API-kalitlar

Ommaviy APIga har qanday soʻrov uchun API-kalit kerak. Kalit yaratish uchun:

1. «Dasturchilar» boʻlimini och va «Kalit yaratish»ni bos.
2. Huquqlarni (scopes) tanla — kalit aynan nima qila olishini.
3. Yaratilgandan soʻng kalitni darhol nusxalab ol.

Заметка

Toʻliq kalit faqat bir marta koʻrsatiladi — yaratilgandan soʻng darhol. Keyin roʻyxatda faqat uning prefiksi koʻrinadi. Agar kalit yoʻqolsa, yangisini yarat.

Huquqlar (scopes)

Scope	Nimaga ruxsat beradi
posts:read	Postlarni oʻqish
posts:write	Postlar yaratish va eʼlon qilish
accounts:read	Ulangan ijtimoiy tarmoqlar roʻyxatini koʻrish
media:read	Mediafayllarni oʻqish
media:write	Mediafayllarni yuklash

Kalitga faqat integratsiyaga haqiqatan kerak boʻlgan huquqlarni ber — bu xavfsizroq.

Avtorizatsiya va limit

Kalit Authorization: Bearer sk_... yoki x-api-key: sk_... sarlavhasida uzatiladi.

Ommaviy APIning limiti — har bir kalit uchun daqiqasiga 60 ta soʻrov. Limitdan oshib ketsang, soʻrovlar rad etila boshlaydi, bir daqiqa kutib davom et.

Kalitni bekor qilish

Agar kalit buzilgan boʻlsa yoki endi kerak boʻlmasa — uni kalitlar roʻyxatidan oʻchir. U darhol ishlashdan toʻxtaydi, u bilan kelgan soʻrovlar rad etiladi.

Misol — curl orqali post yaratish

curl -X POST https://api.repost21.com/v1/posts \
  -H "Authorization: Bearer sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from API 👋",
    "platforms": ["TELEGRAM"],
    "scheduledAt": "2026-07-01T09:00:00Z"
  }'

scheduledAtsiz qoralama yaratiladi, kelajakdagi sana bilan — post «Kontent-reja»ga tushadi va jadval boʻyicha eʼlon qilinadi. Endpointlarning toʻliq roʻyxati — REST API v1 maʼlumotnomasida.

Webhooklar

Webhooklar Repost21da biror hodisa sodir boʻlganda serveringga HTTP-soʻrov yuboradi. Sozlash uchun:

1. «Dasturchilar» boʻlimida webhook qoʻsh — oʻz endpointing URL manzilini koʻrsat.
2. Obuna boʻlmoqchi boʻlgan hodisalarni tanla.
3. Maxfiy kalitni saqlab qoʻy — API-kalit kabi u ham faqat bir marta koʻrsatiladi.

Hodisalar

Hodisa	Qachon keladi
post.created	Post yaratildi
post.published	Post muvaffaqiyatli eʼlon qilindi
post.failed	Eʼlon qilish xatolik bilan yakunlandi

Imzo va tekshiruv

Har bir yetkazib berish quyidagi sarlavhalar bilan POST-soʻrov koʻrinishida keladi:

Sarlavha	Nima saqlaydi
x-repost21-event	Hodisa nomi
x-repost21-signature	sha256=<hex> koʻrinishidagi imzo
x-repost21-delivery	Yetkazib berish ID

Imzo — bu soʻrov tanasidan maxfiy kalit bilan hisoblangan HMAC-SHA256. Uni albatta oʻz tomoningda tekshir: olingan tanadan maxfiy kalit bilan HMAC-SHA256ni hisobla va sarlavha bilan solishtir. Shunday qilib soʻrov aynan Repost21dan kelganiga ishonch hosil qilasan. Node.js uchun tayyor tekshiruv namunasi «Dasturchilar» boʻlimining «Tezkor start» blokida bor.

Совет

Agar serering oʻz vaqtida javob bermasa yoki xatolik qaytarsa, Repost21 yetkazib berishni qaytadan urinib koʻradi — ortib boruvchi interval bilan 5 martagacha. Webhookga tez javob ber (shunchaki 200 OK), ogʻir ishlovni esa asinxron bajar.

Istalgan webhookni oʻchirmasdan, tugmacha orqali vaqtincha oʻchirib qoʻyish mumkin — debug paytida qulay.

RSSdan avtopostlash

Avtopostlash RSS-lentadagi yangi maqolalarni tayyor postlarga aylantiradi — sening ishtirokingsiz. Blog, yangiliklar sayti yoki RSSli har qanday manba uchun mos.

1. «Dasturchilar» boʻlimida «RSSdan avtopostlash» blokini top va lenta qoʻsh — uning URL manzilini koʻrsat. RSS 2.0 va Atom formatlari qoʻllab-quvvatlanadi.
2. Eʼlon qilinadigan ijtimoiy tarmoqlar, postlarning ohangi va tilini tanla.
3. Lentani tekshirish chastotasini belgila — sukut boʻyicha u har 6 soatda tekshiriladi.

Lentada yangi maqolalar paydo boʻlganda, AI ularni oʻqib, tanlangan ijtimoiy tarmoqlarga moslab postlar tayyorlaydi. Sukut boʻyicha postlar qoralama sifatida yaratiladi — sen ularni «Kontent-reja»da koʻrib chiqasan va oʻzing eʼlon qilasan. Agar avtoeʼlonni yoqsang, postlar tekshiruvsiz darhol ijtimoiy tarmoqlarga ketadi.

Заметка

Avtopostlash uchun ijtimoiy tarmoqlar oldindan ulangan boʻlishi kerak — qarang Ijtimoiy tarmoqlarni ulash.

Keyin nima

• Endpointlarning toʻliq maʼlumotnomasi — REST API v1
• Interfeysda postlar va jadval bilan ishlash — Postlar va kontent-reja
• CRM-integratsiyalar (AmoCRM, Bitrix24, RetailCRM, Zapier, Make, Slack) — ishlab chiqilmoqda, «Dasturchilar» boʻlimida ular «Tez orada» deb belgilangan