사업장 사진 조회

이름	유형	필수	설명
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`.

이름

유형

필수

설명

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.

Response

{  "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과 함께 SY90002: Invalid Id가 담긴 errors 배열과 null 페이로드가 반환됩니다.
미디어가 없는 사업장은 { "data": { "mediaFilesOfLocation": [] } }을 반환하며, 이는 오류가 아니라 "Jenny Home"처럼 새로 생성된 사업장에 대한 실제 응답입니다.

매개변수

경로

응답