이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.
카탈로그 항목 교체
put
/catalogs/{catalog_name}/items/{item_id}
이 엔드포인트를 사용하여 카탈로그의 항목을 교체할 수 있습니다.
item_id를 찾을 수 없는 경우 이 엔드포인트가 카탈로그에 해당 항목을 생성합니다. 이 엔드포인트는 동기식으로 작동합니다.
문제 해결
다음 표에는 반환될 수 있는 오류와 관련 문제 해결 단계가 나와 있습니다.
| 오류 | 문제 해결 |
|---|---|
arbitrary-error |
임의의 오류가 발생했습니다. 다시 시도하거나 지원팀에 문의하세요. |
catalog-not-found |
카탈로그 이름이 유효한지 확인하세요. |
filtered-set-field-too-long |
필드 값이 항목의 글자 수 제한을 초과하는 필터링된 세트에서 사용되고 있습니다. |
id-in-body |
요청 본문에서 항목 ID를 모두 제거하세요. |
ids-too-large |
각 항목 ID의 글자 수 제한은 250자입니다. |
invalid-ids |
항목 ID 이름에 사용할 수 있는 문자는 영문자, 숫자, 하이픈, 밑줄입니다. |
invalid-fields |
API 요청에서 보내는 모든 필드가 카탈로그에 이미 존재하는지 확인하세요. 이 오류는 오류 메시지에 언급된 ID 필드와는 관련이 없습니다. |
invalid-keys-in-value-object |
항목 객체 키에는 . 또는 $를 포함할 수 없습니다. |
item-already-exists |
항목이 이미 카탈로그에 존재합니다. |
items-array-is-invalid |
items는 객체 배열이어야 합니다. |
items-too-large |
각 항목의 글자 수 제한은 5,000자입니다. |
request-includes-too-many-items |
요청당 하나의 카탈로그 항목만 생성할 수 있습니다. |
too-deep-nesting-in-value-object |
항목 객체는 50단계를 초과하여 중첩할 수 없습니다. |
unable-to-coerce-value |
항목 유형을 변환할 수 없습니다. |
OpenAPI 문서를 다운로드하여 스키마 유효성 검사에 사용할 수 있습니다. 자세한 방법은 요청 유효성 검사에 OpenAPI 스키마 사용을 참조하세요.
New Stuff!