API Playground: ijtimoiy tarmoq API metodlarini brauzerda sinash
API Playground — socialift.uz kabinetidagi interaktiv muhit. U Facebook, Instagram, LinkedIn, TikTok, Telegram akkaunt va bot, CRM leadlari hamda ulangan akkauntlar bo'yicha 191 ta metodni hujjati bilan jamlaydi, real so'rov yuboradi, uni cURL va JavaScript ko'rinishida hamda mos Python SDK chaqiruvi bilan ko'rsatadi. «Kalitlar» bo'limida esa o'z developer ilovalaringiz kalitlarini qo'shasiz.
Yangilangan:
API Playground nima va u nima uchun kerak?
API Playground — ijtimoiy tarmoq API metodini kod yozmasdan brauzerda chaqirib ko'rish vositasi. Metodni tanlaysiz, qaysi ulangan akkaunt nomidan ishlashni belgilaysiz, formani to'ldirib real so'rov yuborasiz. Javob status, vaqt, sarlavhalar va JSON ko'rinishida keladi, yonida esa shu so'rovning cURL va JavaScript ko'rinishi hamda mos Python SDK namunasi.
So'rovlar haqiqiy: post rostdan e'lon qilinadi, xabar rostdan yuboriladi. Shuning uchun o'chiruvchi va byudjetga ta'sir qiluvchi amallar yuborishdan oldin aniq tasdiq so'raydi.
Playground kod yozish o'rnini bosmaydi. U metodni o'rganish, ruxsatlar yetarliligini tekshirish va xatoni tez topish uchun; ishlab chiqarishda esa xuddi shu chaqiruvlar Python SDK orqali bajariladi.
Playground'da nima bor
Hujjatli 191 ta metod
Har bir metod uchun: nima qiladi, qanday tuzoqlari bor va qaysi ruxsat yoki scope talab qilinadi.
Sxemadan yasalgan forma
Forma real API sxemasidan hosil bo'ladi; xohlasangiz xom JSON muharriri yoki fayl yuklash.
Akkaunt tanlash
So'rov qaysi ulangan akkaunt nomidan yuborilishini ro'yxatdan tanlaysiz.
Javobni ko'rish
Status, bajarilish vaqti, sarlavhalar va qulay JSON ko'ruvchi.
Uch xil kod
cURL va JavaScript fetch — yuborilgan so'rovning aynan o'zi (Socialift server API'si, kabinet JWT bilan); Python — metodning SDK'dagi ekvivalenti namunasi (ko'pchilik metodlarda bor).
Havola va tarix
Aniq metodga to'g'ridan-to'g'ri havola va shu brauzerda saqlanadigan oxirgi so'rovlar tarixi.
Qaysi metodlarni sinash mumkin
| Bo'lim | Metod guruhlari |
|---|---|
| Ulanish, sahifalar va webhook, postlar, story'lar, izohlar, Lead Ads, reklama (targeting, kampaniyalar, auditoriya va statistika) | |
| Ulanish, profil va statistika, postlar, story'lar, izohlar, Direct | |
| Ulanish, profil, postlar | |
| TikTok | Ulanish va profil, videolar va statistika, e'lon qilish, izohlar (Business) |
| Telegram akkaunt | Ulanish, xabarlar, story'lar, guruh va kanallar, a'zolar va moderatsiya, kontaktlar va sessiyalar |
| Telegram bot | Ulanish, xabarlar, chatlar va moderatsiya, webhook va universal chaqiruv |
| CRM va leadlar | Leadlar |
| Ulangan akkauntlar | Akkauntlar |
Izohlar va cheklovlar
Jami 191 ta metod. O'chiruvchi va byudjetga ta'sir qiluvchi amallar yuborishdan oldin aniq tasdiq so'raydi. Story endpoint'lari ham shu yerda sinaladi: Instagram uchun POST va GET /instagram/media/stories, Facebook uchun POST /facebook/stories/photo, POST /facebook/stories/video va GET /facebook/stories, Telegram akkaunti uchun esa GET, POST va PATCH /telegram/stories bilan birga POST /telegram/stories/delete, shuningdek joylashdan oldin shartni tekshiradigan GET /telegram/stories/can-send va GET /telegram/stories/targets.
Kalitlar: o'z developer ilovalaringiz
«Kalitlar» bo'limida har bir platforma uchun o'z ilovangiz kalitlarini qo'shasiz. Sirlar shifrlangan holda saqlanadi va keyin to'liq ko'rsatilmaydi.
- Meta ilovasi
- App ID, app secret va ixtiyoriy Facebook Login for Business configuration ID.
- Instagram Login ilovasi
- Instagram app ID va app secret — Instagram akkauntini Facebook sahifasisiz ulash uchun.
- LinkedIn ilovasi
- Client ID va client secret.
- TikTok ilovasi
- Client key va client secret.
- Telegram API
- api_id va api_hash — Telegram akkauntini ulash uchun. Bot uchun kalit kerak emas: bot tokenining o'zi yetarli.
O'z ilovangiz nima beradi
Login oynasida sizning brendingiz
Foydalanuvchi ruxsat berayotganda sizning ilovangiz nomini ko'radi.
Ilovangizga alohida webhook manzili
Meta, Instagram va TikTok hodisalari ilovangizga ajratilgan Socialift manziliga keladi va sizning app secret'ingiz bilan tekshiriladi. Hozircha ulardan Lead Ads lead'lari (GET /crm/leads) foydalanishga chiqadi; boshqa hodisalarni o'z serveringizda olish uchun callback URL'ni o'z endpoint'ingizga qo'ying va SDK'ning verify_request / verify_tiktok_request yordamchilaridan foydalaning.
Bir bosishda tekshiruv
Kalitlar provayderning o'zida tekshiriladi: Meta, Instagram Login, LinkedIn va TikTok'da client credentials so'rovi, Telegram'da MTProto orqali. Natija: «tekshirilgan», «rad etilgan» yoki aniq javob yo'q (haqiqiy tekshiruv birinchi login'da).
Konsol uchun tayyor qiymatlar
Sahifa provayder konsoliga qo'yiladigan aniq redirect URI'ni ko'rsatadi; kalit saqlangach Meta, Instagram va TikTok uchun webhook manzili va verify token, Meta uchun esa deauthorize va data deletion manzillari ham chiqadi.
Kalitsiz ham ishlaydi
O'z kalitlaringiz bo'lmasa, mavjud joylarda Socialift'ning umumiy ilovasi ishlatiladi.
Ulanishlar va Statistika
«Ulanishlar» sahifasida Facebook (sahifalar va ularga bog'langan Instagram akkauntlari bilan), sahifasiz Instagram, LinkedIn va TikTok OAuth orqali, Telegram akkaunti telefon → kod → 2FA bilan, Telegram bot esa token bilan ulanadi. Tokenlar serverda shifrlangan holda qoladi va brauzerga chiqmaydi.
«Statistika» sahifasi SDK token aktivatsiyalarini Playground va API chaqiruvlaridan alohida, xatolar soni bilan ko'rsatadi. Tokenlar sahifasidagi «Tekshirish va muhitlar» tugmasi token holati va qaysi muhitlar (seat'lar) band ekanini ko'rsatadi — tekshiruvning o'zi seat egallamaydi. Har bir bo'lim kabinet qo'llanmasida batafsil yozilgan.
Birinchi real so'rov — to'rt qadam
Kabinetga kiring
socialift.uz'da Google yoki email orqali kiring va kabinetni oching.
Kalitlarni qo'shing
«Kalitlar» sahifasida o'z ilovangiz kalitlarini kiriting va bir bosishda tekshiring — yoki umumiy ilova mavjud bo'lsa, bu qadamni o'tkazib yuboring.
Akkauntni ulang
«Ulanishlar» sahifasida Facebook, Instagram, LinkedIn, TikTok, Telegram akkaunt yoki botni ulang.
Metodni chaqiring
Playground'da metodni tanlang, akkauntni belgilang, formani to'ldirib yuboring va tayyor kodni nusxalang.
Playground'dan to'g'ri foydalanish
- So'rovlar haqiqiy — sinov uchun alohida sahifa, akkaunt yoki botdan foydalaning.
- O'chirish yoki byudjetga ta'sir qiluvchi amalni tasdiqlashdan oldin parametrlarni qayta ko'rib chiqing.
- Metod hujjatidagi tuzoqlar va talab qilinadigan ruxsatlarni o'qing — ko'p xatolarning sababi shu yerda yozilgan.
- Jamoadoshingizga aynan kerakli so'rovni metodga to'g'ridan-to'g'ri havola orqali ulashing.
- Kalit tekshiruvi aniq javob bermasa, bu kalit noto'g'ri degani emas — provayder uni oldindan tasdiqlamaydi, haqiqiy tekshiruv birinchi login'da bo'ladi.
- Ishlab chiqarishda Python SDK ishlating — Python yorlig'idagi namuna shu uchun; cURL/JavaScript namunalari kabinet JWT'si bilan Socialift server API'sini chaqiradi.
Ko'p so'raladigan savollar
Playground'dagi so'rovlar haqiqiymi?
Ha. Post rostdan e'lon qilinadi, xabar rostdan yuboriladi. Shuning uchun o'chiruvchi va byudjetga ta'sir qiluvchi amallar yuborishdan oldin aniq tasdiq so'raydi.
Playground kod yozish o'rnini bosadimi?
Yo'q. Playground metodlarni o'rganish va sinash uchun. Ishlab chiqarishda Python SDK ishlatiladi — Playground metodning SDK'dagi ekvivalentini (mavjud bo'lsa) va yuborilgan so'rovning cURL/JavaScript ko'rinishini beradi.
O'z app kalitlarim nima uchun kerak?
O'z ilovangiz bilan login oynasida sizning brendingiz ko'rinadi, Meta/TikTok webhooklari esa ilovangizga ajratilgan manzilga kelib, sizning secret'ingiz bilan tekshiriladi. Kalit qo'shmasangiz, mavjud joylarda Socialift'ning umumiy ilovasi ishlatiladi.
Kalitlar va tokenlar qanday saqlanadi?
App sirlari shifrlangan holda saqlanadi va keyin to'liq ko'rsatilmaydi. Ulangan akkauntlarning tokenlari ham serverda shifrlangan holda qoladi va brauzerga chiqmaydi.
Kalitlarni tekshirish qanday ishlaydi?
Bir bosishda kalitlar provayderning o'zida tekshiriladi: Meta, Instagram Login, LinkedIn va TikTok'da client credentials so'rovi, Telegram'da MTProto orqali. Natija «tekshirilgan», «rad etilgan» yoki aniq javob yo'q bo'ladi — oxirgi holatda haqiqiy tekshiruv birinchi login'da o'tadi.
Playground'dan foydalanish uchun nima kerak?
socialift.uz'da Google yoki email orqali kirish va kerakli akkauntni «Ulanishlar» sahifasida ulash. SDK tokeni kerak emas: Playground token rejasidan qat'i nazar ishlaydi.
Manbalar
Bog'liq sahifalar
Birinchi so'rovni hozir yuboring
Google yoki email bilan kiring, akkauntni ulang va istalgan metodni Playground'da sinang.
Playground'ni ochish →