Skip to main content
ORCA
MES
KR

OPEN API 키 발급/관리

OPEN API 설명 절차입니다.

필요하시면 ORCA 팀에서 연동을 지원해드립니다.

발급 전 확인

  • ORCA 고객사 마스터 계정으로 로그인해야 합니다.
  • Pro 모델 이상의 구독이 필요합니다.
  • 키는 고객사 사용자 정보를 기준으로 검증하며 별도 선택형 scope를 추가하지 않습니다.

ORCA에서 키 발급

  1. ORCA에 로그인한 뒤 연동관리 → OPEN API 키 관리로 이동합니다.
  2. Key 생성을 선택하고 용도를 식별할 이름과 필요한 경우 만료일을 입력합니다.
  3. 생성 직후 표시되는 원본 key를 복사합니다. 이후에는 API KEY 관리 상세에서 다시 복사할 수 있습니다.
ORCA API key 생성 모달. 키 이름과 만료일(선택)을 입력하는 화면ORCA API key 생성 직후 모달. 원본 키와 복사 버튼이 있는 화면ORCA API key 상세 모달. 원문 키를 표시하고 복사할 수 있는 화면

ORCA OPEN API key management →

보관 원칙

  • Browser, 모바일 앱, 공개 repository 또는 주문 DB에 저장하지 않습니다.
  • Authorization header와 원본 key를 로그에 남기지 않습니다.
  • 담당자 변경이나 유출 의심 시 새 key를 발급한 뒤 기존 key를 폐기합니다.

조회와 폐기

목록에서는 이름, prefix, 상태, 생성일, 만료일과 최근 사용일만 확인할 수 있습니다.

원문은 API KEY 관리 상세에서 다시 복사할 수 있으며, 폐기 즉시 인증에 사용할 수 없습니다.

폐기된 key는 목록에서 삭제할 수 있습니다. 활성 key는 먼저 폐기해야 합니다.

발급이 불가능하면 ORCA 운영 담당자가 Master Admin의 입점사 외부 연동 관리에서 고객사 권한과 key 상태를 확인합니다.

ORCA API KEY 관리 화면. 이름, prefix, 상태, 생성일, 마지막 사용, 만료일이 표시된 목록

Next: Sales-order integration →