Listings APIListings API
로그인
POST/api/v4/locations/listings/mark-as-duplicate

등록 정보를 중복으로 표시

감지된 등록 정보 항목을 1개 이상 확정된 중복으로 표시하여 Listings API가 숨김 처리할 수 있도록 합니다.

API 키가 필요합니다. 헤더 형식과 키 교체는 인증을 참고하세요.

매개변수

본문

이름유형필수설명
input.listingItemIdsarray필수Array of base64-encoded listing item IDs to mark as duplicates. Use the `listingItemId` values from the duplicate-listings endpoints.
input.locationIdstring선택Location that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location.

요청 예시

바로 붙여 넣을 수 있는 본문입니다. 예시 ID와 값을 실제 값으로 바꾸세요.

Request body
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]  }}

응답

200Listing items marked as duplicates. On failure, `success` is `false` and `errors` describes why.
Response
{  "data": {    "markAsDuplicate": {      "success": true,      "errors": null    }  }}
400Validation error, e.g. an unknown or malformed listing item ID. See the `errors` array (`code`, `message`, `path`).
401Unauthenticated, missing or invalid API key.

특정 등록 정보 항목이 중복임을 확인하여 Listings API에 해당 항목을 숨김 처리하거나 정리하도록 알립니다. 사업장의 중복 등록 정보 조회에서 반환된 listingItemId 값(또는 계정 전체 집계의 id 값)으로 listingItemIds를 채웁니다.

사용 사례: 검토한 중복 항목 처리

검토자가 중복 그룹을 확인한 후, 해당 항목의 ID를 한 번의 호출로 제출합니다:

JSON
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]  }}

listingItemIds는 필수이며 여러 ID를 허용하므로, 등록 정보별로 호출하는 대신 한 사업장에서 확인된 모든 중복 항목을 하나의 요청으로 일괄 제출합니다. success: true를 포함하는 200은 항목이 숨김 처리를 위해 접수되었음을 의미하며, success: false를 포함하는 200(또는 400)은 항목이 채워진 errors 배열을 반환하므로 재시도하기 전에 각 항목의 code 및 message를 확인합니다.

사용 사례: 실수 되돌리기

항목이 잘못 표시된 경우, 동일한 본문 구조를 사용하는 등록 정보를 중복이 아닌 것으로 표시로 되돌립니다. 이는 쓰기 작업이며 계정의 요청 빈도 제한에 산정되므로, 항목별 요청보다 일괄 요청을 권장합니다.

Request
curl -X POST 'https://listingsapi.com/api/v4/locations/listings/mark-as-duplicate' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "locationId": "TG9jYXRpb246MTgwMDI4OQ==",      "listingItemIds": [        "TGlzdGluZ0l0ZW06MjM1OTg0NTA="      ]    }  }'
Run in playground