/api/v4/connected-accounts/{connectedAccountId}/detailsDapatkan detail akun yang terhubung
Mengembalikan detail satu akun Google atau Facebook yang terhubung berdasarkan ID-nya.
Parameter
Path
| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| connectedAccountId | string | wajib | UUID of the connected account (from the list connected accounts endpoint). |
Respons
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.
Mengambil rekaman detail lengkap untuk satu akun yang terhubung, yang ditentukan melalui connectedAccountId akun tersebut. Endpoint ini mengembalikan field yang sama dengan satu rekaman dari endpoint daftar, tetapi terbatas pada satu akun, sehingga lebih hemat daripada menelusuri seluruh halaman daftar saat Anda sudah memiliki ID-nya.
Kasus penggunaan: periksa akun yang baru terhubung secara berkala. Setelah pelanggan menyelesaikan alur koneksi Google, Anda memiliki connectedAccountId, tetapi pengambilan kecocokan berjalan secara asinkron. Periksa endpoint ini secara berkala dan pantau requestMatchesStatus: nilainya berubah dari MATCH_IN_PROGRESS menjadi MATCH_COMPLETED setelah saran siap, dan pada saat itu Anda dapat membacanya dari endpoint connection-suggestions.
Kasus penggunaan: tampilkan pesan untuk meminta autentikasi ulang. Sebelum mengirim pembaruan melalui suatu akun, baca status dan connectivityIssue. Status selain CONNECTED atau connectivityIssue yang terisi berarti pemberian akses OAuth telah kedaluwarsa; minta pelanggan untuk menghubungkan kembali akun di aplikasi Anda alih-alih mencoba publikasi yang akan gagal. connectedLocationsCount memberi tahu Anda berapa banyak lokasi Listings API yang saat ini ditautkan ke akun tersebut.
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts/<connectedAccountId>/details' \ -H "Authorization: API $LISTINGSAPI_KEY"