GET
/api/v4/locations/{locationId}/photosجلب صور موقع
يعيد جميع ملفات الوسائط المرفقة بموقع واحد، بما فيها الصور المميزة بنجمة وغير المميزة بنجمة.
المعلمات
المسار
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| locationId | string | مطلوب | The location's Base64-encoded Relay ID (for example `TG9jYXRpb246MTgwMDI4OQ==`). The raw numeric database ID (`1800289`) is also accepted, and so is a percent-encoded value such as `...%3D%3D`. |
الاستجابات
200Array of media files for the location. Returns an empty array when the location has no photos.
{ "data": { "mediaFilesOfLocation": [ { "id": "TWVkaWFGaWxlOjU4Nzg5MzE=", "url": "https://sy-media-store.s3-us-west-2.amazonaws.com/f868bb3f/59c670a3/f47d62a6.jpg", "thumbnailUrl": "https://sy-media-store.s3-us-west-2.amazonaws.com/f868bb3f/59c670a3/thumbnail_f47d62a6.jpg", "categoryName": "Logo", "categoryId": "4", "fileType": "image", "starred": false, "viewsCount": 0 }, { "id": "TWVkaWFGaWxlOjU4Nzg5MzI=", "url": "https://sy-media-store.s3-us-west-2.amazonaws.com/f868bb3f/59c670a3/ef4ffb12.jpg", "thumbnailUrl": "https://sy-media-store.s3-us-west-2.amazonaws.com/f868bb3f/59c670a3/thumbnail_ef4ffb12.jpg", "categoryName": "Additional", "categoryId": "12", "fileType": "image", "starred": true, "viewsCount": 143 } ] }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
يعيد كل ملف وسائط مرفق بموقع: الشعار وصورة الغلاف والصور الإضافية، مع url العام لكل ملف، وthumbnailUrl، والفئة، وما إذا كان starred، وviewsCount على مدى عمر الملف.
حالة استخدام: عرض معرض صور موقع. اجلب قائمة الوسائط لعرض الصور المنشورة بالفعل للنشاط التجاري، باستخدام thumbnailUrl للعرض الشبكي وurl للعرض بالحجم الكامل. يوضح لك starred الصور الإضافية المثبتة لمنحها أولوية في العرض على منصات النشر المدعومة.
حالة استخدام: تدقيق اكتمال الوسائط قبل رفع ملفات. استدعِ نقطة النهاية هذه أولًا لمعرفة ما إذا كان الموقع يفتقر إلى صورة من الفئة Logo أو Cover، ثم ارفع ما ينقص فقط. قيم id المُعادة هي بالضبط ما تمرره إلى نقطتي النهاية للتمييز بنجمة والإزالة.
تنبيهات.
- يمكن استخدام أي من صيغ id في المسار: تشير
1800289وTG9jYXRpb246MTgwMDI4OQ==وTG9jYXRpb246MTgwMDI4OQ%3D%3Dجميعها إلى الموقع نفسه. تؤدي القيمة التي لا تطابق أيًا من هذه الصيغ إلى إرجاع HTTP 200 مع مصفوفةerrorsتحتوي علىSY90002: Invalid Idوحمولة بياناتnull. - يعيد الموقع الذي لا يحتوي على وسائط
{ "data": { "mediaFilesOfLocation": [] } }، وهذه هي الاستجابة الفعلية لموقع أُنشئ حديثًا مثل "Jenny Home"، وليست خطأً.
Request
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/photos' \ -H "Authorization: API $LISTINGSAPI_KEY"