이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.

카탈로그 항목 생성

post

/catalogs/{catalog_name}/items/{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 스키마 사용하기를 참조하세요.