LinkedIn klienti: OAuth, profil va postlar

Callback'dagi code ni /oauth/v2/accessToken da (form-urlencoded) access tokenga almashtiradi va TokenBundle qaytaradi.

await li.exchange_code(code: str, *, redirect_uri: str) -> socialift.models.TokenBundle

• ▸LinkedIn qoidasi: code 30 daqiqa amal qiladi; redirect_uri avtorizatsiya so'rovidagi bilan bir xil bo'lishi kerak.
• ▸Access token 60 kun amal qiladi; refresh_token faqat app'da programmatik refresh yoqilgan bo'lsa keladi.
• ▸Javobda access_token bo'lmasa ApiError.

Klientni LINKEDIN_CLIENT_ID, LINKEDIN_CLIENT_SECRET va LINKEDIN_API_VERSION muhit o'zgaruvchilaridan yaratadi. Kalitlar kodda turmasligi uchun.

LinkedIn.from_env(**kwargs) -> LinkedIn

• ▸Bo'sh qiymatlar konstruktorda tekshirilmaydi: client_id yo'qligi login_url da ConfigurationError bo'lib chiqadi.
• ▸LINKEDIN_API_VERSION berilmasa SDK'dagi standart versiya ishlatiladi — u LinkedIn'da hali faol ekanini tekshiring.

A'zoni LinkedIn avtorizatsiya sahifasiga (/oauth/v2/authorization) yuborish uchun havola yasaydi; so'rov yubormaydi. Scope'lar probel bilan ajratiladi, standart: openid, profile, email, w_member_social.

li.login_url(
    *,
    redirect_uri: str,
    state: Optional[str] = None,
    scopes: Optional[list[str]] = None,
) -> str

• ▸client_id bo'lmasa ConfigurationError.
• ▸state — CSRF himoyasi: callback'dagi qiymat siz yuborganiga teng bo'lmasa so'rovni rad eting (LinkedIn tavsiyasi). SDK uni saqlamaydi.
• ▸LinkedIn qoidasi: a'zo so'ralgan scope'larni alohida tanlay olmaydi; ilgari berilganidan boshqa scope so'ralsa avvalgi barcha access tokenlar bekor bo'ladi.
• ▸redirect_uri app'ning Auth bo'limidagi redirect URL'lardan biriga mos bo'lishi kerak.

url = li.login_url(redirect_uri="https://siz.uz/cb", state=state)

Tokenni /oauth/v2/introspectToken da tekshiradi va LinkedIn javobini lug'at sifatida qaytaradi: active, status, expires_at, scope, auth_type va boshqalar. Token hali ishlayaptimi va qachon tugashini bilish uchun.

await li.introspect(token: str) -> dict

• ▸status: active, expired yoki revoked; scope faqat 3-legged OAuth tokenlari uchun keladi.
• ▸LinkedIn qoidasi: kalitlar to'g'ri, lekin token boshqa app'niki bo'lsa javob 200 va active: false bo'ladi — xato ko'tarilmaydi.

info = await li.introspect(token)

Refresh token bilan yangi access token oladi (grant_type=refresh_token) va TokenBundle qaytaradi. Token tugashidan oldin a'zoni qayta login qildirmaslik uchun.

await li.refresh(refresh_token: str) -> socialift.models.TokenBundle

• ▸LinkedIn programmatik refresh tokenlarni faqat tasdiqlangan Marketing Developer Platform hamkorlariga beradi; bo'lmasa a'zo avtorizatsiyadan qayta o'tadi.
• ▸Refresh token 365 kun amal qiladi va yangilash uning muddatini uzaytirmaydi; yangi access token 60 kunlik.
• ▸Javobda access_token bo'lmasa ApiError.

bundle = await li.refresh(refresh_token)

OpenID Connect userinfo (/v2/userinfo) dan a'zo profilini Profile sifatida qaytaradi: id (= sub), ism, rasm va email. sub post muallifi URN'ini yasash uchun kerak.

await li.me(token: str) -> socialift.models.Profile

• ▸openid va profile scope'lari kerak, email uchun email; LinkedIn hujjatiga ko'ra email maydoni ixtiyoriy va javobda bo'lmasligi mumkin.
• ▸Profile.username — email, u bo'lmasa sub; Profile.raw da locale'dan olingan qo'shimcha language bor.

Kerakli ruxsatlar:openidprofileemail

me = await li.me(token)

sub ni urn:li:person:{sub} ko'rinishiga keltiradi — posts va create_post dagi author uchun. Statik metod, so'rov yubormaydi.

LinkedIn.person_urn(sub: str) -> str

• ▸create_post va posts urn: bilan boshlanmagan qiymatni o'zi shunday o'raydi.

Kerakli ruxsatlar:r_member_socialw_member_social

posts = await li.posts(token, author=li.person_urn(sub), count=10)

post = await li.create_post(token, author=li.person_urn(sub), text="Yangiliklar!",
                             article_url="https://siz.uz/blog")

A'zo nomidan matnli post (ixtiyoriy havola bilan) Posts API'da yaratadi va {id, body} qaytaradi; id — x-restli-id sarlavhasidagi post URN'i. visibility: PUBLIC yoki CONNECTIONS.

await li.create_post(
    token: str,
    *,
    author: str,
    text: str,
    visibility: str = 'PUBLIC',
    article_url: Optional[str] = None,
    article_title: Optional[str] = None,
) -> dict

• ▸w_member_social kerak (Share on LinkedIn mahsuloti).
• ▸Havola uchun SDK content.article ga source va title (berilmasa URL) yozadi. LinkedIn Posts API URL'ni skanerlamaydi, shuning uchun thumbnail va tavsif avtomatik chiqmaydi.
• ▸Boshqa visibility qiymati ConfigurationError beradi.
• ▸Rasm, video va hujjat yuklash bu metodda yo'q.

Kerakli ruxsatlar:w_member_social

post = await li.create_post(token, author=li.person_urn(sub), text="Yangiliklar!",
                             article_url="https://siz.uz/blog")

Postni URN bo'yicha (urn:li:share:... yoki urn:li:ugcPost:...) o'chiradi va {deleted: True, urn} qaytaradi. URN yo'l qismida to'liq kodlanadi.

await li.delete_post(token: str, post_urn: str) -> dict

• ▸LinkedIn qoidasi: o'chirish idempotent — avval o'chirilgan post uchun ham 204 qaytadi; ommaviy o'chirish yo'q.
• ▸w_member_social kerak; amalni qaytarib bo'lmaydi.

Kerakli ruxsatlar:w_member_social

await li.delete_post(token, post_urn)

Muallif postlarini Posts API'ning q=author so'rovi bilan o'qiydi va LinkedIn javobini (elements, paging) qaytaradi. start va count bilan sahifalanadi.

await li.posts(token: str, *, author: str, start: int = 0, count: int = 10) -> dict

• ▸A'zo postlari uchun r_member_social kerak — LinkedIn uni cheklangan ruxsat sifatida faqat tasdiqlangan foydalanuvchilarga beradi; 403 da SDK tushuntiruvchi PermissionError ko'taradi.
• ▸LinkedIn qoidasi: count standart 10, maksimal 100; natijalar oxirgi o'zgartirilgan vaqt bo'yicha yangidan eskiga tartiblanadi.
• ▸Keyingi postlar bo'lsa ham sahifada count dan kam element kelishi mumkin — keyingi sahifani paging.links dan aniqlang.

Kerakli ruxsatlar:r_member_social

posts = await li.posts(token, author=li.person_urn(sub), count=10)

Istalgan HTTP so'rovni yuboradi va JSON javobni qaytaradi — SDK'da hali alohida metodi yo'q endpoint uchun. Token va imzo parametrlarini (access_token, Meta uchun appsecret_proof — socialift.crypto.appsecret_proof) o'zingiz params yoki headers ga qo'shasiz.

await li.request(
    method: str,
    url: str,
    *,
    params: Optional[Mapping[str, Any]] = None,
    data: Optional[Any] = None,
    json: Optional[Any] = None,
    headers: Optional[Mapping[str, str]] = None,
) -> Any

• ▸params dagi None qiymatlar yuborilmaydi.
• ▸Limit (RateLimitError) va vaqtinchalik server xatolarida (HTTP 429, 500, 502, 503, 504) RetryPolicy bo'yicha qayta uriniladi; Retry-After sarlavhasi bo'lsa, shuncha kutiladi. Tarmoq uzilishi TransportError bo'lib chiqadi.

request("GET", ...) ning qisqa shakli.

await li.get(url: str, **kw) -> Any

request("POST", ...) ning qisqa shakli.

await li.post(url: str, **kw) -> Any

request("DELETE", ...) ning qisqa shakli.

await li.delete(url: str, **kw) -> Any

Meta'ning kursorli sahifalashi (paging.next) bo'yicha yurib, barcha data elementlarini bitta ro'yxatga yig'ib qaytaradi.

await li.paginate(
    url: str,
    *,
    params: Optional[Mapping[str, Any]] = None,
    max_items: int = 500,
    page_size: int = 100,
) -> list[dict]

• ▸max_items (standart 500) — himoya chegarasi: yirik akkauntda ro'yxat o'n minglab yozuv bo'lishi mumkin. page_size — bitta so'rovdagi limit.

SDK o'zi yaratgan HTTP sessiyasini yopadi (tashqaridan berilgan sessiyaga tegmaydi). async with Client(...) ishlatilsa, o'zi chaqiriladi.

await li.close() -> None