/api/v4/connected-accounts/{connectedAccountId}/detailsBağlı hesap ayrıntılarını alın
Tek bir bağlı Google veya Facebook hesabının ayrıntılarını ID'sine göre döndürür.
Parametreler
Yol
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| connectedAccountId | string | zorunlu | UUID of the connected account (from the list connected accounts endpoint). |
Yanıtlar
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.
Tek bir bağlı hesabın tüm ayrıntılarını içeren kaydı, hesabın connectedAccountId değeriyle getirir. Bu, liste uç noktasındaki tek bir kayıtla aynı alanları döndürür ancak kapsamı tek bir hesapla sınırlıdır; ID zaten elinizdeyse bu yöntem, tüm listeyi sayfa sayfa almaktan daha az maliyetlidir.
Kullanım örneği: yeni bağlanmış bir hesabı düzenli aralıklarla sorgulayın. Müşteri Google bağlantı akışını tamamladıktan sonra elinizde bir connectedAccountId olur ancak eşleşmeleri getirme işlemi eşzamansız çalışır. Bu uç noktayı düzenli aralıklarla sorgulayın ve requestMatchesStatus değerini izleyin: öneriler hazır olduğunda MATCH_IN_PROGRESS değerinden MATCH_COMPLETED değerine geçer; bu noktada önerileri connection-suggestions uç noktasından okuyabilirsiniz.
Kullanım örneği: yeniden kimlik doğrulama isteyen bir mesaj gösterin. Bir hesap üzerinden güncellemeleri göndermeden önce status ve connectivityIssue değerlerini okuyun. Durumun CONNECTED dışında bir değer olması veya connectivityIssue alanının dolu olması, OAuth yetkilendirmesinin süresinin dolduğu anlamına gelir; başarısız olacak bir yayımlama girişiminde bulunmak yerine müşteriden uygulamanızda hesabı yeniden bağlamasını isteyin. connectedLocationsCount, şu anda hesaba kaç Listings API konumunun bağlı olduğunu belirtir.
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts/<connectedAccountId>/details' \ -H "Authorization: API $LISTINGSAPI_KEY"