> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Отримання Link Session > Перевірте, чи URL для прив'язки соціальних мереж відкривали, чи він досі дійсний і чи його не відкликано. export const PlansAvailable = ({plans = [], maxPackRequired}) => { let displayPlans = plans; if (plans && plans.length === 1) { const lowerCasePlan = plans[0].toLowerCase(); if (lowerCasePlan === "business") { displayPlans = ["Launch", "Business", "Enterprise"]; } else if (lowerCasePlan === "premium") { displayPlans = ["Premium", "Launch", "Business", "Enterprise"]; } } return Available on {displayPlans.length === 1 ? "the " : ""} {displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "} {displayPlans.length > 1 ? "plans" : "plan"}. {maxPackRequired && window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer"> Max Pack required } ; }; export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <> API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY {!noProfileKey && (profileKeyRequired ? Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY : Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY )} ; Перевірте стан URL для підключення, створеного за допомогою [Створення Link Session](/docs/apis/profiles/create-link-session), — чи відкривав його ваш користувач, чи він досі дійсний і скільки разів його використовували. Корисно, коли ви хочете дізнатися, чи почав користувач підключати свої акаунти, не питаючи його, або підтвердити, що посилання вже не працює, перш ніж створювати заміну. `sessionId`, який не існує або належить іншому акаунту, повертає ту саму відповідь `not found`. Це зроблено навмисно, щоб ендпоінт не можна було використати для з'ясування, чи існує ідентифікатор насправді. ## Header Parameters ## Path Parameters `sessionId`, повернутий під час створення посилання. ## Стани посилання Поле `state` набуває одного зі значень: * `pending`: створено, ніколи не відкривали. * `active`: відкрито щонайменше один раз, досі в межах свого вікна. * `expired`: минув `expiresAt`. * `revoked`: анульовано за допомогою [Відкликання Link Session](/docs/apis/profiles/revoke-link-session). Відкликане посилання повідомляє `revoked` навіть після завершення свого вікна, оскільки це корисніша відповідь. ## Підключені акаунти Коли ваш користувач підключає акаунт, посилання це фіксує. Три поля з'являються, щойно щось було підключено, а до того вони відсутні: * `completedAt`: коли було підключено перший акаунт. * `lastCompletedAt`: коли було підключено останній. * `completedNetworks`: кожна мережа, підключена через це посилання. Ці поля окремі від `state`, і обидва відповідають на реальні запитання: посилання може бути `active` і ще нічого не підключити, або `expired` і підключити три акаунти до свого завершення. Опитування `completedNetworks` — це те, як застосунок із серверним рендерингом або мобільний застосунок дізнається, що підключення завершилося, і єдиний сигнал для Telegram, який завершує підключення поза основним потоком. **`completedNetworks` — це історія цієї сесії зв'язування, а не поточний стан профілю.** Список лише поповнюється: мережа додається, коли вона підключається через цю сесію, і ніколи не видаляється, тож вона залишається в переліку після того, як акаунт від'єднано, повторно зв'язано через іншу сесію або відключено на боці мережі. Щоб побачити, які мережі зв'язані з User Profile **просто зараз**, викличте [Отримання User Profiles](/docs/apis/profiles/get-profiles) з `include=state`. ```bash cURL theme={"system"} curl \ -H "Authorization: Bearer API_KEY" \ -H 'Profile-Key: PROFILE_KEY' \ -X GET https://api.ayrshare.com/api/profiles/link-sessions/SESSION_ID ``` ```javascript JavaScript theme={"system"} const API_KEY = "API_KEY"; const PROFILE_KEY = "PROFILE_KEY"; const SESSION_ID = "SESSION_ID"; fetch(`https://api.ayrshare.com/api/profiles/link-sessions/${SESSION_ID}`, { headers: { Authorization: `Bearer ${API_KEY}`, "Profile-Key": PROFILE_KEY, }, }) .then((res) => res.json()) .then((json) => console.log(json)) .catch(console.error); ``` ```python Python theme={"system"} import requests headers = {'Authorization': 'Bearer API_KEY', 'Profile-Key': 'PROFILE_KEY'} response = requests.get( 'https://api.ayrshare.com/api/profiles/link-sessions/SESSION_ID', headers=headers) print(response.json()) ``` ```php PHP theme={"system"} request( 'GET', 'https://api.ayrshare.com/api/profiles/link-sessions/SESSION_ID', [ 'headers' => [ 'Authorization' => 'Bearer API_KEY', 'Profile-Key' => 'PROFILE_KEY' ] ] ); echo json_encode(json_decode($res->getBody()), JSON_PRETTY_PRINT); ``` ```csharp C# theme={"system"} using System; using System.Net.Http; using System.Threading.Tasks; namespace GetLinkSession_csharp { class GetLinkSession { static async Task Main(string[] args) { string API_KEY = "API_KEY"; string PROFILE_KEY = "PROFILE_KEY"; string url = "https://api.ayrshare.com/api/profiles/link-sessions/SESSION_ID"; try { using (var client = new HttpClient()) { client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY); client.DefaultRequestHeaders.Add("Profile-Key", PROFILE_KEY); HttpResponseMessage response = await client.GetAsync(url); response.EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); Console.WriteLine(responseBody); } } catch (HttpRequestException e) { Console.WriteLine($"HTTP request error: {e.Message}"); } } } } ``` ```json 200: Opened Once, Still Valid theme={"system"} { "status": "success", "sessionId": "c7a2434e72e91bde27579efde0fd6dd0b74ceee29a471fd368407f273708c2e8", "state": "active", // pending | active | expired | revoked - see Link States above. "createdAt": "2026-09-01T08:03:26.838Z", // When the link was created, as an ISO 8601 timestamp. "expiresAt": "2026-09-02T08:03:26.838Z", // When the link stops working. "firstUsedAt": "2026-09-01T08:14:02.104Z", // When the link was first opened. Absent if it never has been. "lastUsedAt": "2026-09-01T08:14:02.104Z", // When the link was most recently opened. Absent if it never has been. "useCount": 1, // How many times the link has been opened. A reload or an OAuth retry increments this. "completedAt": "2026-09-01T08:15:44.870Z", // When the first account was connected. Absent until one is. "lastCompletedAt": "2026-09-01T08:16:20.412Z", // When the most recent was connected. Absent until one is. "completedNetworks": ["reddit", "bluesky"] // Every network connected on this link, append-only. Absent until one is. } ``` ```json 200: Created, Never Opened theme={"system"} { "status": "success", "sessionId": "c7a2434e72e91bde27579efde0fd6dd0b74ceee29a471fd368407f273708c2e8", "state": "pending", // Created but never opened, so firstUsedAt and lastUsedAt are absent. "createdAt": "2026-09-01T08:03:26.838Z", "expiresAt": "2026-09-02T08:03:26.838Z", "useCount": 0 } ``` ```json 404: Not Found theme={"system"} { "action": "link session", "status": "error", "code": 502, "message": "Social linking session not found. Please request a new linking URL." } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.