/api/v4/reviewDetailsجلب التفاعلات حسب المعرّفات
يُرجع كائنات التفاعل الكاملة لمجموعة محددة من معرّفات التفاعلات.
المعلمات
الاستعلام
| الاسم | النوع | مطلوب | الوصف | الافتراضي |
|---|---|---|---|---|
| interactionIds | string | مطلوب | JSON-encoded array of interaction IDs to fetch, e.g. `["b2fa765e-c62b-4e0b-b1d6-1c67c855f5e0"]`. Passed as a URL-encoded JSON string. | — |
الاستجابات
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.
يجلب تفاصيل التفاعل الكاملة لمعرّف تفاعل محدد واحد أو أكثر. يفيد ذلك عندما تكون لديك معرّفات تفاعلات مخزّنة وتحتاج إلى بيانات حديثة لها دون التنقل عبر صفحات قائمة التفاعلات الكاملة. يحتوي جسم الاستجابة على data.interactionDetails.interactions، وهو مصفوفة من كائنات التفاعل (راجع مرجع سمات التفاعل).
مرّر interactionIds كمصفوفة JSON مرمّزة للاستخدام في URL. عندما لا ينتمي أحد المعرّفات إلى حسابك، تُرجع نقطة النهاية 200 مع تعيين data.interactionDetails إلى null ومصفوفة errors (مثل SY90001: Not Authorized to access this resource)؛ ويؤدي حذف المعامل بالكامل إلى إرجاع SY90006.
حالة استخدام: تحديث بيانات قائمة متابعة مخزّنة
إذا كنت تنشئ نظام إشعارات يخزّن معرّفات التفاعلات (مثل التقييمات التي ميّزها المستخدم بنجمة)، فاستدعِ نقطة النهاية هذه دوريًا لتحديث بياناتها واكتشاف أي responses جديد ينشره المالك أو أي تغيير في علامة responded، دون الحاجة إلى إعادة فحص قائمة التقييمات بأكملها. إن responses[].id المُرجع هنا هو responseId الذي تمرّره إلى تعديل رد أو أرشفة رد.
curl -X GET 'https://listingsapi.com/api/v4/reviewDetails?interactionIds=<interactionIds>' \ -H "Authorization: API $LISTINGSAPI_KEY"