상품 AI 통신

XGEN AI 상품 상세 설명 생성

post

기능 설명

상품 기본 정보를 기반으로 XGEN AI를 이용해 상품 상세 설명을 생성합니다.

상세 내용

• 단건의 상품에 대해 상품번호로 상품정보를 조회합니다.

• 생성 옵션은 공통코드(PR050)를 대상으로 합니다.

• 생성시 추가 설명을 제공할 수 있습니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

AI 상품 상세 설명 생성 요청 DTO

goodsNostring · min: 1Required

상품번호

Example: 10002671

optionstring · min: 1Required

AI상품설명옵션(PR050)

Example: 10

additionalInfostringOptional

추가정보

Responses

200

XGEN AI 상품 상세 설명 생성 성공

*/*

AI 상품 상세 설명 생성 응답 DTO

resultstringOptional

생성 결과

contentstringOptional

AI가 생성한 내용 (텍스트 또는 JSON 문자열)

900

XGEN AI 상품 상세 설명 생성 실패

*/*

post/v2/goods/ai/getAiGoodsDesc

HTTPcURLJavaScriptPython

POST /api/bo/v2/goods/ai/getAiGoodsDesc HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "goodsNo": 10002671,
  "option": 10,
  "additionalInfo": "text"
}

{
  "result": "text",
  "content": "text",
  "citations": [
    {
      "file_name": "text",
      "page_number": 1
    }
  ]
}

XGEN AI상품 목록 조회

get

기능설명

• XGEN AI가 추천하는 상품 목록을 조회합니다.

---

상세설명

• 검색 조건에 따라 상품 목록을 조회합니다.

• 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.

---

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

AI 상품 목록 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

AI 상품 목록 조회 실패

*/*

get/v2/goods/ai/getAiGoodsList

HTTPcURLJavaScriptPython

GET /api/bo/v2/goods/ai/getAiGoodsList?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-07-14T10:18:51.896Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "totalCount": 1,
    "payloads": [
      {
        "goodsNo": "text",
        "goodsNm": "text",
        "goodsCompCd": "text",
        "goodsTypCd": "text",
        "goodsReason": "text",
        "entrNm": "text",
        "entrNo": "text",
        "brandNm": "text",
        "saleMethCd": "text",
        "saleStatCd": "text",
        "saleStatCdNm": "text",
        "buyTypCd": "text",
        "deliProcTypCd": "text",
        "deliGoodsGbCd": "text",
        "deliWayCd": "text",
        "goodsRegDtm": "2026-07-14T10:18:51.896Z",
        "mdNm": "text",
        "dispYn": "text",
        "deliProcTypCdNm": "text",
        "deliGoodsGbCdNm": "text",
        "salePrc": 1,
        "dispDlexAmt": "text",
        "stdCtgHierarchy": "text",
        "buyrAgeLmtCd": "text",
        "buyQtyLmtYn": "text",
        "minLmtQty": 1,
        "maxLmtQty": 1,
        "rglrDeliGoodsYn": "text"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Deprecated

AI상품 목록 조회

get

기능설명

• AI가 추천하는 상품 목록을 조회합니다.

---

상세설명

• 검색 조건에 따라 상품 목록을 조회합니다.

• 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.

---

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

AI 상품 목록 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

AI 상품 목록 조회 실패

*/*

get/v1/goods/ai/getAiGoodsList

HTTPcURLJavaScriptPython

GET /api/bo/v1/goods/ai/getAiGoodsList?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-07-14T10:18:51.896Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "totalCount": 1,
    "payloads": [
      {
        "goodsNo": "text",
        "goodsNm": "text",
        "goodsCompCd": "text",
        "goodsTypCd": "text",
        "goodsReason": "text",
        "entrNm": "text",
        "entrNo": "text",
        "brandNm": "text",
        "saleMethCd": "text",
        "saleStatCd": "text",
        "saleStatCdNm": "text",
        "buyTypCd": "text",
        "deliProcTypCd": "text",
        "deliGoodsGbCd": "text",
        "deliWayCd": "text",
        "goodsRegDtm": "2026-07-14T10:18:51.896Z",
        "mdNm": "text",
        "dispYn": "text",
        "deliProcTypCdNm": "text",
        "deliGoodsGbCdNm": "text",
        "salePrc": 1,
        "dispDlexAmt": "text",
        "stdCtgHierarchy": "text",
        "buyrAgeLmtCd": "text",
        "buyQtyLmtYn": "text",
        "minLmtQty": 1,
        "maxLmtQty": 1,
        "rglrDeliGoodsYn": "text"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Deprecated

AI 상품 상세 설명 생성

get

기능 설명

상품 기본 정보를 기반으로 AI를 이용해 상품 상세 설명을 생성합니다.

상세 내용

• 단건의 상품에 대해 상품번호로 상품정보를 조회합니다.

• 생성 옵션은 공통코드(PR050)를 대상으로 합니다.

• 생성시 추가 설명을 제공할 수 있습니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

AI 상품 상세 설명 생성 성공

*/*

AI 상품 상세 설명 생성 응답 DTO

resultstringOptional

생성 결과

contentstringOptional

AI가 생성한 내용 (텍스트 또는 JSON 문자열)

900

AI 상품 상세 설명 생성 실패

*/*

get/v1/goods/ai/getAiGoodsDesc

HTTPcURLJavaScriptPython

GET /api/bo/v1/goods/ai/getAiGoodsDesc?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "result": "text",
  "content": "text",
  "citations": [
    {
      "file_name": "text",
      "page_number": 1
    }
  ]
}