bldinit Cj Logistics Rest API
The cj_logistics-rest API from bldinit — 9 operation(s) for cj_logistics-rest.
The cj_logistics-rest API from bldinit — 9 operation(s) for cj_logistics-rest.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-cj-logistics-rest-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: mcpweave Cj Logistics Rest API
description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
version: '2026-04-27'
tags:
- name: cj_logistics-rest
paths:
/api/v1/cj_logistics/ReqOneDayToken:
post:
tags:
- cj_logistics-rest
summary: 1Day Token 발급 (24h 유효, internal)
description: '영구 API Token (`CJ-Gateway-APIKey` header) + biz_reg_num + cust_id
+ user_id 로 24시간 유효한 1Day Token 발급. 모든 비즈니스 op은
body 의 `token_num` 필드에 이 토큰을 담아 호출.
**mcpweave internal**: 사용자에게 노출되지 않음. background refresh
worker가 매 22시간마다 자동 갱신. 사용자는 영구 API Token + 4 메타
필드만 입력 (`/admin/connections/cj_logistics/setup`).
▶ 1Day 토큰발행
- 서비스 명: WS_OPENAPI_006_FL
- API 명: ReqOneDayToken
- Comment:
i) Nplus TB_MSCD_CODE_D 의 BSEVAL = ''P'' 면 운영, 그 외 개발
(개발의 경우 승인대기등록 로직 skip, 값에 따라 API Gateway
URL 개발/운영으로 셋팅)
ii) 전체 Application 조회 시 나오는 token key 는 암호화된 값.
해당 Application id 로 상세조회 필요.'
operationId: cj_issue_one_day_token
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/cj_logistics/RegBook:
post:
tags:
- cj_logistics-rest
summary: 예약 접수 (송장등록)
description: '운송장 발급 + 예약. 발송인 / 수령인 / 주문자 / 상품 (다품목) /
포장 / 일정 / 운임 정보를 한 번에 등록.
▶ (일반) 예약 접수
- 서비스 명: WR_OPENAPI_001_FL
- API 명: RegBook
- Comment:
i) 고객의 요청으로 Response 의 에러메시지는 오라클 에러만 return.
mcpweave 의 client 가 ORA-XXXX 패턴을 sanitize 후 사용자 응답
(ADR-013 정합).
**mcpweave 사용 팁**: 75 필드 모두 raw 노출 (ADR-001 native pass-
through). 다만 MCP tool 호출 시 prompt 폭발을 피하려면 minimal-set
helper (`cj_create_shipment_minimal`, future) 도 검토.'
operationId: cj_create_shipment
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/cj_logistics/CnclBook:
post:
tags:
- cj_logistics-rest
summary: 예약 취소
description: '등록된 송장의 예약을 취소. body schema 는 RegBook 와 **완전 동일**
(75 필드). CJ 의 idempotency 모델 추정 — `work_dv_cd` 또는
`req_dv_cd` 로 구분. mcpweave 가 sandbox dogfood 시 minimal payload
(cust_id + token_num + invc_no) 만으로 동작 가능한지 실험 후 확정.'
operationId: cj_cancel_shipment
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/cj_logistics/ReqInvcNo:
post:
tags:
- cj_logistics-rest
summary: 운송장 번호 사전발급
description: '실제 등록 (RegBook) 하지 않고 운송장 번호만 미리 발급. 인쇄 시스템
연동 환경에서 송장 라벨 사전 출력 후 batch 등록 시 사용.
대부분의 사용자는 RegBook 만으로 충분 (CJ 가 자동 발급). 이 op
은 P1 (필요 시).'
operationId: cj_generate_waybill_number
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/cj_logistics/ReqOneGdsTrc:
post:
tags:
- cj_logistics-rest
summary: 단건 추적 — 운송장 번호 기준
description: '운송장 번호 1개의 현재 상태 + 이력 조회. 사용자가 알고 있는
특정 송장의 즉시 조회용. polling worker 와는 별개의 ad-hoc 호출.
응답에 status code (`crg_st`, 10/20/30/40/50/60/80/99) + 한국어
라벨 (`crg_st_nm`) + 시간순 history 배열 포함 (추정, sandbox 확정 예정).'
operationId: cj_track_waybill
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/cj_logistics/ReqMssGdsTrc:
post:
tags:
- cj_logistics-rest
summary: 다건 추적 — 예약 정보 기준 (메시지 큐)
description: '지정 일자의 미수신 상태 변화 메시지를 한 번에 fetch. mcpweave
의 polling worker 가 이 op 을 주기적으로 호출 (default 2분 jittered).
- `req_dt` = 조회 일자 YYYYMMDD (보통 오늘 또는 어제~오늘)
- `snd_yn` = ''N'' 미수신만 / '''' 또는 ''Y'' 전체
한 호출로 **여러 송장의 여러 상태 변화** 큐 형태로 받음 →
webhook event 다건 합성에 효율적. 받은 메시지는 반드시
`cj_confirm_tracking_ack` 으로 확정 (큐에서 제거).
▶ (일반)상품 추적(예약 정보 기준)
- 서비스 명: WS_OPENAPI_xxx_FL (정확한 코드 sandbox 확정)'
operationId: cj_track_messages
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/cj_logistics/RcvMssGdsTrcCnfrm:
post:
tags:
- cj_logistics-rest
summary: 메시지 수신 확정 — polling ack
description: 'cj_track_messages 로 받은 메시지를 array 로 ack. CJ 가 큐에서
제거 (`snd_yn = ''Y''` 변경) → 다음 호출 시 재수신 X. **dedup /
idempotency 자동 보장**.
mcpweave 의 polling worker 가 webhook event 발사 후 즉시 호출.
사용자 ad-hoc 호출은 거의 없음.'
operationId: cj_confirm_tracking_ack
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/cj_logistics/ReqAddrRfn:
post:
tags:
- cj_logistics-rest
summary: 주소 정제 (도로명/지번 정규화 + 우편번호)
description: '입력 주소를 CJ 표준 주소 형식으로 정제. 송장등록 (RegBook) 호출
전 사전 검증 — 배송 불가 주소를 미리 거름. 사용자 입력
주소가 불완전 (예: 우편번호 missing) 할 때 보정.
응답에 정규화된 도로명/지번 + 우편번호 + 행정구역 코드 포함
(추정, sandbox 확정).'
operationId: cj_validate_address
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/cj_logistics/ReqAddrRfnWfr:
post:
tags:
- cj_logistics-rest
summary: 주소 정제 + 운임 추정
description: 'ReqAddrRfn 의 확장 — 정제된 주소 기준으로 **운임 견적**까지 반환.
송장등록 전 사용자에게 사전 안내 ("이 주소로 5,500원 부과됩니다").
▶ (공통)주소 정제(운임포함)
- 서비스 명: WS_OPENAPI_014_FL
- API 명: ReqAddrRfnWFr
- Comment: i) Nplus DB 에 connection 이 실패해도 수행해야 함
(운임 산출은 critical path → DB 장애 시 fallback)'
operationId: cj_estimate_tariff
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)