/api/v4/reviewDetailsEtkileşimleri kimliklerine göre alın
Belirli bir etkileşim kimliği kümesi için tam etkileşim nesnelerini döndürür.
Parametreler
Sorgu
| Ad | Tür | Zorunlu | Açıklama | Varsayılan |
|---|---|---|---|---|
| interactionIds | string | zorunlu | JSON-encoded array of interaction IDs to fetch, e.g. `["b2fa765e-c62b-4e0b-b1d6-1c67c855f5e0"]`. Passed as a URL-encoded JSON string. | — |
Yanıtlar
200Interaction details for the requested IDs. `data.interactionDetails.interactions` holds the array.
{ "data": { "interactionDetails": { "interactions": [ { "id": "b2fa765e-c62b-4e0b-b1d6-1c67c855f5e0", "source": "maps.google.com", "content": "Great place for dessert!", "authorName": "Jordan M.", "category": "Review", "type": "Review", "rating": 5, "date": "2026-05-12T09:22:41+00:00", "responded": true, "responseCount": 1, "canRespond": true, "responses": [ { "id": "2090753a-ece6-4837-8336-8494ad308523", "content": "Thank you so much for the kind words!", "authorName": "Jenny Home", "date": "2026-05-13T14:02:00+00:00", "interactionStatus": "CONFIRMED", "editedResponse": false } ] } ] } }}401Unauthenticated, missing or invalid API key.
Bir veya daha fazla belirli etkileşim kimliği için tüm etkileşim ayrıntılarını getirir. Etkileşim kimliklerini kaydettiyseniz ve etkileşim listesinin tamamını sayfa sayfa dolaşmadan bu etkileşimlerin güncel verilerine ihtiyacınız varsa kullanışlıdır. Yanıt gövdesi, etkileşim nesnelerinden oluşan bir dizi olan data.interactionDetails.interactions şeklindedir (bkz. etkileşim öznitelikleri başvuru kaynağı).
interactionIds parametresini URL kodlamalı bir JSON dizisi olarak iletin. Bir kimlik hesabınıza ait olmadığında uç nokta, data.interactionDetails değeri null olarak ayarlanmış ve bir errors dizisi içeren 200 döndürür (e.g. SY90001: Not Authorized to access this resource); parametre tamamen atlandığında ise SY90006 döndürür.
Kullanım örneği: kayıtlı bir izleme listesini güncel verilerle doldurma
Etkileşim kimliklerini (örneğin, bir kullanıcının yıldız eklediği yorumların kimliklerini) kaydeden bir bildirim sistemi oluşturuyorsanız bu etkileşimlerin verilerini yenilemek ve işletme sahibinin yeni yayımladığı responses veya değişen bir responded bayrağını tespit etmek için bu uç noktayı düzenli aralıklarla çağırın; yorum listesinin tamamını yeniden taramanıza gerek yoktur. Burada döndürülen responses[].id, Bir yanıtı düzenleyin veya Bir yanıtı arşivleyin işlemine ilettiğiniz responseId değeridir.
curl -X GET 'https://listingsapi.com/api/v4/reviewDetails?interactionIds=<interactionIds>' \ -H "Authorization: API $LISTINGSAPI_KEY"