Product Catalog

Get Product By Website Slug

get/v1/products/by-website-slug/{website_slug}

Request

  • Base URL: https://api.xdata.kr (the document declares no server; this is the origin it was published from)
  • URL: https://api.xdata.kr/v1/products/by-website-slug/{website_slug}
  • Auth: one of:
    • HTTP basic
    • OAuth 2 (authorization code, authorization URL https://api.xdata.kr/oauth/authorize, token URL https://api.xdata.kr/oauth/token)

Path parameters

website_slugstring required

Query parameters

env_scope'production' | 'real_test' | 'sandbox' nullable

환경을 고릅니다. 값은 production · real_test · sandbox 중 하나입니다. 경로 접두(/v1/sandbox/... · /v1/test/... · /v1/production/...) · X-Env-Scope 헤더 · env_scope 쿼리 가운데 한 통로로 반드시 보내야 합니다. 빼면 자동으로 채우지 않고 거절하며, 두 통로에 서로 다른 값을 담아도 거절합니다. 거절은 HTTP 422 이고 오류 코드는 VALIDATION_ENV_SCOPE_MISMATCH 입니다.

Headers

Authorizationstring nullable
X-Env-Scope'production' | 'real_test' | 'sandbox' nullable

환경을 고릅니다. 값은 production · real_test · sandbox 중 하나입니다. 경로 접두(/v1/sandbox/... · /v1/test/... · /v1/production/...) · X-Env-Scope 헤더 · env_scope 쿼리 가운데 한 통로로 반드시 보내야 합니다. 빼면 자동으로 채우지 않고 거절하며, 두 통로에 서로 다른 값을 담아도 거절합니다. 거절은 HTTP 422 이고 오류 코드는 VALIDATION_ENV_SCOPE_MISMATCH 입니다.

Response

Successful Response

idinteger required

api_products.id.

codestring required
namestring required
descriptionstring nullable

카탈로그 설명. ProductCreateRequest.description 과 같은 정책이다 - 화면이 sanitize 를 맡고 최대 10000자.

status'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'RETIRED' required
visibility'PUBLIC' | 'PRIVATE' | 'ENTERPRISE' required
category'tax' | 'gov' | 'finance' | 'marketing' nullable
organization_idinteger nullable
env_scope'sandbox' | 'real_test' | 'production' required
current_version_idinteger nullable

활성 버전 포인터. DRAFT 상태에서만 NULL 허용 — ACTIVE/DEPRECATED/RETIRED 상태에서는 반드시 있어야 한다.

metadataobject

자유 메타데이터. 정책을 결정하는 키는 넣을 수 없다. JSON 직렬화 후 최대 65536 bytes.

monitoring_gradeinteger nullable

Ops monitoring grade 1..5.

website_slugstring nullable

Public Website slug for routing.

collection_sitesstring[]

Active collection site codes (product_collection_site SSOT).

created_atstring date-time required
updated_atstring date-time required
deleted_atstring date-time nullable

soft delete 시각. NULL=활성, NOT NULL=삭제 완료.

mcp_tool_namestring nullable

이 상품의 활성 버전 (provider, action) 에 해당하는 MCP 도구 이름. null 이면 그 쌍에 도구 행이 없다(활성 버전이 없을 때도 null).

mcp_tool_enabledboolean

그 도구가 켜져 있고 이 env_scope 에서 팔리는가. false 는 꺼졌거나 이 레인에서 팔지 않는다는 뜻이며 '준비 중' 을 뜻하지 않는다.

Changes

No recorded changes to this operation across all 1 revision of this API.