bldinit Cj Logistics Rest API

The cj_logistics-rest API from bldinit — 9 operation(s) for cj_logistics-rest.

GitHub OpenAPI

Operations 9

POST /api/v1/cj_logistics/ReqOneDayToken 1Day Token 발급 (24h 유효, internal) #
POST /api/v1/cj_logistics/RegBook 예약 접수 (송장등록) #
POST /api/v1/cj_logistics/CnclBook 예약 취소 #
POST /api/v1/cj_logistics/ReqInvcNo 운송장 번호 사전발급 #
POST /api/v1/cj_logistics/ReqOneGdsTrc 단건 추적 — 운송장 번호 기준 #
POST /api/v1/cj_logistics/ReqMssGdsTrc 다건 추적 — 예약 정보 기준 (메시지 큐) #
POST /api/v1/cj_logistics/RcvMssGdsTrcCnfrm 메시지 수신 확정 — polling ack #
POST /api/v1/cj_logistics/ReqAddrRfn 주소 정제 (도로명/지번 정규화 + 우편번호) #
POST /api/v1/cj_logistics/ReqAddrRfnWfr 주소 정제 + 운임 추정 #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-cj-logistics-rest-api"
All apis
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.

Get an API 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 Specification

mcpweave-com-cj-logistics-rest-api-openapi.yml Raw ↑
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)