How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

xdata-kr Product Catalog API

The Product Catalog API from xdata-kr — 7 operation(s) for product catalog.

xdata-kr Product Catalog API is one of 31 APIs that xdata-kr publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Product Catalog. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 11 operations across 7 paths, and defines 23 schemas. It is described by OpenAPI 3.2.0, at version 2.0.0.

11 operations 7 paths 23 schemas 1 DELETE6 GET1 PATCH2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0.0
Authentication
HTTP Basic, OAuth 2.0
Resource Areas
1

Authentication & Security 2

xdata-kr Product Catalog API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (basicClientCredential). It supports OAuth 2.0 (mcpOAuth2) using the authorizationCode flow. By default, every request must be authenticated.

  • basicClientCredential — Console-issued client credential. Send Authorization: Basic base64(clientid:clientsecret).
  • mcpOAuth2 — For MCP clients. OAuth 2.0 authorization code flow with PKCE (S256) for public clients. The clientid is the HTTPS URL of an OAuth Client ID Metadata Document t…

Paths & Operations 11

Across 7 paths, the API surfaces 11 operations — 1 DELETE, 6 GET, 1 PATCH, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Product Catalog 11
POST
/v1/products
Create Product
create_product_v1_products_post 4 params body → 201422
GET
/v1/products
List Products
list_products_v1_products_get 4 params → 200422
GET
/v1/products/by-website-slug/{website_slug}
Get Product By Website Slug
get_product_by_website_slug_v1_products_by_website_slug__website_slug__get 4 params → 200422
GET
/v1/products/{product_id}
Get Product
get_product_v1_products__product_id__get 6 params → 200422
PATCH
/v1/products/{product_id}
Update Product
update_product_v1_products__product_id__patch 5 params body → 200422
DELETE
/v1/products/{product_id}
Delete Product
delete_product_v1_products__product_id__delete 5 params body → 200422
GET
/v1/products/{product_id}/plan-mappings
List Product Plan Mappings
list_product_plan_mappings_v1_products__product_id__plan_mappings_get 5 params → 200422
GET
/v1/catalog/page-copy-homes
Get Page Copy Homes
get_page_copy_homes_v1_catalog_page_copy_homes_get 3 params → 200422
PUT
/v1/catalog/page-copy-homes
Put Page Copy Homes
put_page_copy_homes_v1_catalog_page_copy_homes_put 3 params body → 200422
POST
/v1/catalog/page-copy-homes/check
Check Page Copy Homes
check_page_copy_homes_v1_catalog_page_copy_homes_check_post 3 params body → 200422
GET
/v1/catalog/page-copy-homes/history
Get Page Copy Homes History
get_page_copy_homes_history_v1_catalog_page_copy_homes_history_get 3 params → 200422

Schemas 23

The contract defines 23 schemas that model the data the API accepts and returns. The most detailed are ProductResponse (26 properties), ProductListItem (21 properties), ProductListQuery (14 properties), ProductCreateRequest (12 properties). Each schema is shown below with its type and property counts.

CommonCopyDraftRequest
object
2 properties 1 required
ProductFactsPrerequisiteLogin
object
이 상품을 부르기 전에 먼저 불러야 하는 로그인.
2 properties 2 required
ProductUpdateRequest
object
PATCH /v1/products/{productid} 요청 본문. 모든 필드 선택. immutable 컬럼은 extra='forbid'로 본 DTO에서 차단: - code / organizationid / envscope / currentversionid 는 본 DTO에 미선언. 클…
9 properties
InitialVersionRequest
object
POST /v1/products 요청 본문에 nested로 동봉되는 초기 버전. 초기 버전 동시 발행 옵션이다. 동봉 시 단일 트랜잭션으로 apiproducts + apiproductversions 동시 INSERT.
9 properties 3 required
ProductFacts
object
상품 상세페이지 안내 블록이 읽는 서버가 아는 사실. 도구 계약에서 만들어 손으로 적지 않는다. 모르는 값은 null 로 둔다 - 그럴듯한 값으로 채우지 않는다. 특히 irreversible 은 조회면 false 이고 쓰기는 상품이 되돌릴 수 없음을 선언하기 전까지 null 이다(쓰기…
7 properties 7 required
ProductCreateRequest
object
POST /v1/products 요청 본문. SCHEMA → DTO 매핑: - code/name/description/category/status/visibility/organizationid → 직접 매핑. envscope는 헤더 X-Env-Scope에서 주입(본문에 없음). - m…
12 properties 2 required
ProductFactsCredential
object
이 상품을 쓰기 전에 연동해 둬야 하는 자격.
4 properties 4 required
ProductListItem
object
GET /v1/products 목록 응답 1행. 목록 응답은 상세보다 가벼운 필드 집합 — description 등 큰 필드 미노출. currentversionsummary nested 를 동봉한다.
21 properties 8 required
PlanProductMappingListQuery
object
Shared list query for plan mapping GET endpoints (Sprint 1 SS7 read extension).
3 properties
ProductListQuery
object
GET /v1/products 쿼리 파라미터. 페이지네이션 + 필터. 헤더 X-Env-Scope 는 서비스 레벨에서 강제 부착(본 DTO 영역 외).
14 properties
PageCopyHomesBody
object
4 properties
ProductDeleteResponse
object
DELETE /v1/products/{productid} 응답 본문. status 는 변경되지 않는다 — soft delete 와 RETIRED 진입은 독립 차원이다.
4 properties 4 required
ProductFactsLimits
object
결과 파일에 관한 한도. 파일을 내주지 않는 상품은 둘 다 null.
2 properties
ValidationError
object
5 properties 3 required
ProductDeleteRequest
object
DELETE /v1/products/{productid} 요청 본문(선택). reason 단일 선택 필드. 본 DTO는 본문이 없을 때도 삭제 호출이 정상 동작하도록 모든 필드 Optional.
1 property
PlanProductMappingWithPlanItem
object
Reverse-index mapping row (GET /v1/products/{id}/plan-mappings).
8 properties 7 required
StatusTransition
object
상태 전이 본문 - statustransition. PATCH /v1/products/{productid} 요청 본문에 nested로 동봉. 허용 전이는 상태 전이 매트릭스(ALLOWEDTRANSITIONS)에 따른다. 비허용 전이 시 라우트/서비스/DB 트리거 단계에서 409 CAT…
2 properties 2 required
ProductResponse
object
상품 단일 객체 응답. SCHEMA → DTO 매핑: - apiproducts.id → id. - code/name/description/category/status/visibility/organizationid/ envscope/currentversionid/metadata/crea…
26 properties 8 required
PageEnvelope_PlanProductMappingWithPlanItem_
object
3 properties
InitialVersionEcho
object
POST /v1/products 응답에 nested로 동봉되는 초기 버전 요약. 초기 버전을 동봉했을 때 응답 본문의 initialversion nested 가 이 모양이다. version · provider · action 은 상품 등록과 같은 꼴 · 같은 길이(최대 64자)로 잠근…
6 properties 5 required
HTTPValidationError
object
1 property
PageEnvelope_ProductListItem_
object
3 properties
CurrentVersionSummary
object
상품 응답에 nested 로 동봉되는 활성 버전 요약. GET /v1/products(목록) + GET /v1/products/{id}(상세) 응답에 동봉. 전체 ProductVersionResponse(11+ 필드)가 아닌 운영자 카탈로그 표시에 필요한 핵심 필드만 추려 응답 크기를…
5 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

xdata-kr-product-catalog-api-openapi.yml Raw ↑

Other APIs xdata-kr publishes across the network.

xdata-kr App Credential API
xdata-kr Auth API
xdata-kr Auth Handoff API
xdata-kr Billing Invoices API
xdata-kr Billing Payment Methods API
xdata-kr Billing Payments API
xdata-kr Billing Plans API
xdata-kr Billing Refunds API
xdata-kr Billing Standard Checkout API
xdata-kr Billing Subscriptions API
xdata-kr Billing Webhooks API
xdata-kr Composite Pack API
Where this information came from

This is an independent, third-party profile of xdata-kr Product Catalog API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.