TikTok API uchun developer app sozlash

TikTok app nima beradi?

TikTok for Developers'da app yaratish va sozlash

1. 1

   Ro'yxatdan o'ting va app yarating

   TikTok for Developers'ga kiring va app yarating. TikTok app'ni tashkilot (organization) nomidan ro'yxatdan o'tkazishni tavsiya qiladi; shaxsiy developer akkaunt haqiqiy integratsiya uchun tavsiya etilmaydi.

2. 2

   App ma'lumotlarini to'ldiring

   Ikonka (1024×1024 px, JPEG/JPG/PNG, 5 MB gacha), nom, kategoriya, tavsif (avtorizatsiya sahifasida ko'rinadi), Terms of Service URL va Privacy Policy URL. 2024-yil 9-sentyabrdan keyin yaratilgan app'larda bu URL'lar tasdiqlanadi. Web platformasi uchun rasmiy sayt URL'i kerak.

3. 3

   Login Kit va redirect URI qo'shing

   Products → Add products → Login Kit. Redirect URI qoidalari: https bilan boshlanadigan absolyut manzil, statik, query parametr va # siz; ko'pi bilan 10 ta, har biri 512 belgidan kam; so'rovdagi redirect_uri ro'yxatdagisiga aynan mos kelishi shart.

4. 4

   Content Posting API qo'shing va Direct Post'ni yoqing

   Content Posting API mahsulotini qo'shing va uning sozlamalarida Direct Post konfiguratsiyasini yoqing. To'g'ridan-to'g'ri e'lon qilish uchun app video.publish scope'iga tasdiq olgan va foydalanuvchi uni bergan bo'lishi kerak.

5. 5

   Scope'larni qo'shing

   Scopes bo'limida integratsiya haqiqatan ishlatadigan scope'larni qo'shing (pastdagi jadval). Credentials bo'limidan Client key va Client secret'ni ko'chiring.

6. 6

   PULL_FROM_URL uchun URL egaligini tasdiqlang

   URL properties vidjetida Domain (masalan cdn.siz.uz — undagi barcha yo'llar) yoki URL prefix (https:// + host + yo'l + /) qo'shib tasdiqlang. Media URL https bo'lishi, boshqa manzilga yo'naltirmasligi va yuklab olish davomida (vazifa boshlangandan bir soatgacha) ochiq turishi kerak. Aks holda API url_ownership_unverified (403) qaytaradi. Faylni o'zingiz yuklasangiz (FILE_UPLOAD) domen tasdig'i kerak emas.

7. 7

   Webhook callback URL'ni sozlang

   App sozlamalarida callback URL'ni kiriting (faqat HTTPS). Endpoint darhol 200 qaytarishi kerak: aks holda TikTok yetkazishni muvaffaqiyatsiz deb hisoblab, 72 soatgacha eksponensial kechikish bilan qayta yuboradi. Yetkazish “kamida bir marta” — takroriy hodisalarni filtrlang.

8. 8

   Sandbox'da sinang

   Sandbox — review'ga yubormasdan integratsiyani sinash uchun cheklangan muhit. Unda test akkauntlar bilan login va e'lon oqimini to'liq o'tkazing — demo video ham shu yerda yoziladi.

9. 9

   Demo video bilan review'ga yuboring

   Har bir mahsulot va scope app'da qanday ishlatilishini batafsil yozing. Kamida bitta demo video (5 tagacha, har biri 50 MB gacha): to'liq end-to-end oqim, interfeys va foydalanuvchi harakatlari; web app'da videodagi domen sayt URL'iga mos bo'lishi kerak. Sayt to'liq ishlaydigan bo'lsin, Terms of Service va Privacy Policy havolalari menyu ochmasdan ko'rinsin. Direct Post'dagi private cheklovini olib tashlash uchun Content Posting API audit'i alohida o'tiladi.

TikTok app'ni Socialift'ga ulash

1. 1

   Kalitlar → TikTok app

   Kabinetda “Kalitlar” bo'limida “TikTok app” kartasini oching. “Konsolga ko'chiring” blokidagi Redirect URI'ni Login Kit sozlamasiga belgi-belgi ko'chiring — oxiridagi / ham farq qiladi.

2. 2

   Client key va Client secret'ni kiriting

   “Scope'lar” ixtiyoriy: bo'sh qoldirilsa user.info.basic, user.info.profile, user.info.stats, video.list, video.upload, video.publish so'raladi. “Saqlash va tekshirish” — Socialift TikTok token endpoint'idan client access token so'rab kalitni tekshiradi.

3. 3

   Webhook URL'ni ko'chiring

   Saqlangandan keyin kartada Webhook URL chiqadi — uni TikTok callback URL maydoniga qo'ying. Hodisalar sizning Client secret'ingiz bilan imzo bo'yicha tekshiriladi. Kartada “Webhook verify token” qatori ham ko'rinadi, lekin TikTok'da bunday maydon yo'q — uni e'tiborsiz qoldiring.

4. 4

   Akkauntni ulang

   “Ulanishlar” bo'limida TikTok kartasidagi “Ulash” ni bosing. Access token 24 soat yashaydi — “Token'ni yangilash” uni refresh token bilan yangilaydi. Playground'da e'lon metodlarini SELF_ONLY bilan sinang.

Qaysi scope nima uchun kerak?

E'londan oldin creator_info chaqirilishi shart: privacy_level faqat u qaytargan privacy_level_options dan biri bo'lishi kerak, aks holda privacy_level_option_mismatch.

Python SDK'da TikTok kalitlari

TikTok.from_env() TIKTOK_CLIENT_KEY va TIKTOK_CLIENT_SECRET ni o'qiydi.

import asyncio
import secrets

from socialift import TikTok

REDIRECT_URI = "https://siz.uz/auth/tiktok/callback"  # Login Kit'dagi bilan belgi-belgi bir xil


async def main() -> None:
    # TIKTOK_CLIENT_KEY, TIKTOK_CLIENT_SECRET, SOCIALIFT_LICENSE_KEY
    async with TikTok.from_env() as tt:
        print(tt.login_url(redirect_uri=REDIRECT_URI, state=secrets.token_urlsafe(32)))

        bundle = await tt.exchange_code(input("code: "), redirect_uri=REDIRECT_URI)
        info = await tt.creator_info(bundle.access_token)  # e'londan oldin majburiy
        print(info["privacy_level_options"])
        result = await tt.publish_video(bundle.access_token, video_url="https://cdn.siz.uz/reel.mp4",
                                        title="Salom TikTok!", privacy_level="SELF_ONLY", wait=True)
        print(result)


asyncio.run(main())

Ko'p uchraydigan xatolar

• ▸Redirect URI Login Kit'dagidan farq qiladi: http, oxiridagi / yoki query parametr.
• ▸Audit'dan o'tmagan app'da ochiq post e'lon qilishga urinish — kontent private ko'rinishda cheklanadi, akkaunt ochiq bo'lsa unaudited_client_can_only_post_to_private_accounts.
• ▸creator_info chaqirilmagan yoki privacy_level u qaytargan ro'yxatda yo'q.
• ▸PULL_FROM_URL tasdiqlanmagan domendan yoki redirect qiladigan URL'dan — url_ownership_unverified.
• ▸Yangilashdan keyin eski refresh token saqlanib qolgan — keyingi urinish rad etiladi.
• ▸Token endpoint'iga JSON yuborilgan — application/x-www-form-urlencoded kerak.
• ▸Demo videodagi domen app'dagi sayt URL'iga mos emas yoki bir mahsulot videoda ko'rsatilmagan.
• ▸Webhook endpoint'i og'ir ishni bajarib, 200 ni kech qaytaradi — TikTok qayta yuboradi va dubllar paydo bo'ladi.