/api/v4/connected-accounts/{connectedAccountId}/detailsالحصول على تفاصيل حساب متصل
يُرجع تفاصيل حساب Google أو Facebook متصل واحد باستخدام معرّفه.
المعلمات
المسار
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| connectedAccountId | string | مطلوب | UUID of the connected account (from the list connected accounts endpoint). |
الاستجابات
200Connected account details.
{ "data": { "connectedAccountDetails": { "details": { "accountId": "12345", "clientName": "owner@brightsmile-dental.com", "connectedAccountId": "4f712c17-4f95-42dd-90f4-97171a2e67b5", "connectedAccountType": "GoogleAccount", "connectedLocationsCount": 0, "connectivityIssue": null, "email": "owner@brightsmile-dental.com", "lastFetchMatchesRequestedAt": "2026-07-06 21:43:07 UTC", "remarks": null, "requestMatches": false, "requestMatchesStatus": "MATCH_COMPLETED", "status": "CONNECTED" } } }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
يجلب سجل التفاصيل الكامل لحساب متصل واحد، باستخدام connectedAccountId الخاص به. يُرجع هذا الحقول نفسها التي يحتوي عليها سجل واحد من نقطة نهاية القائمة، لكن ضمن نطاق حساب واحد، وهو أقل تكلفة من استعراض جميع صفحات القائمة عندما يكون المعرّف لديك بالفعل.
حالة استخدام: الاستعلام دوريًا عن حساب متصل حديثًا. بعد أن يُكمل العميل خطوات ربط حساب Google، يصبح لديك connectedAccountId، لكن جلب المطابقات غير متزامن. استعلم دوريًا من نقطة النهاية هذه وراقب requestMatchesStatus: فهو ينتقل من MATCH_IN_PROGRESS إلى MATCH_COMPLETED بمجرد أن تصبح الاقتراحات جاهزة، وعندها يمكنك قراءتها من نقطة النهاية connection-suggestions.
حالة استخدام: مطالبة العميل بإعادة المصادقة. قبل إرسال التحديثات عبر حساب، اقرأ status وconnectivityIssue. وجود حالة غير CONNECTED أو قيمة في connectivityIssue يعني أن صلاحية تفويض OAuth قد انتهت؛ اطلب من العميل إعادة ربط الحساب في تطبيقك بدلًا من محاولة نشر ستفشل. يوضّح لك connectedLocationsCount عدد مواقع Listings API المرتبطة بالحساب حاليًا.
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts/<connectedAccountId>/details' \ -H "Authorization: API $LISTINGSAPI_KEY"