로그인회원가입

엔터프라이즈 API

ERP 동기화용 버전 REST API. Authorization: Bearer gcn_live_… 또는 gcn_test_… 로 인증. Business 대시보드에서 키 생성.

처음이신가요? 파트너 온보딩 체크리스트부터 시작하세요.

기본 URL

/api/v1

기계 판독 OpenAPI: /api/v1/openapi

Postman 컬렉션: 다운로드 / 가져오기

핵심 엔드포인트

  • GET /me — org + scopes
  • GET|POST /listings, /listings/bulk
  • GET|POST /inventory, /inventory/bulk (syncMode: upsert|replace)
  • /freight, /freight/bulk · /depots, /depots/bulk · /storage, /storage/bulk · /manufacturers, /manufacturers/bulk · /ports, /ports/bulk
  • /inquiries, /inquiries/{id}/reply
  • /organization, /webhooks, /bulk/{jobId}

스코프

새 키는 모든 스코프를 받습니다. 데이터 모델로 세분화 제한 가능.

  • listings:read
  • listings:write
  • inventory:read
  • inventory:write
  • freight:read
  • freight:write
  • depots:read
  • depots:write
  • storage:read
  • storage:write
  • manufacturers:read
  • manufacturers:write
  • ports:read
  • ports:write
  • inquiries:read
  • inquiries:write
  • org:read
  • org:write
  • webhooks:manage
  • bulk:write

파트너 빠른 시작

카탈로그 동기화(전체 모듈), 문의, 웹훅용 curl 예시:

docs/api-partner-guide.md

준비 상태 프로브: /api/v1/ready

참고

  • 미검증 조직: 생성은 관리자 승인까지 PENDING 유지.
  • 검증된 조직: API 생성/업데이트가 ACTIVE로 자동 게시.
  • 안전한 ERP 재시도를 위해 externalId + Idempotency-Key 사용.
  • 벌크 최대 200개/요청. 웹훅은 백오프로 최대 3회 재시도.
  • 웹훅은 HMAC 서명(x-gcn-signature, x-gcn-timestamp).

확인 중…