오너클랜 API 사용 신청 — 자동 발주·발송에 필요한 인증키 발급받기
A-Flow 의 OC 자동발주 · 자동발송 매칭 · 메모 자동 채움 기능을 쓰려면 오너클랜 API 사용 신청이 먼저 필요합니다. 신청은 무료이고 보통 즉시 승인됩니다.
📌 이 글에서 다루는 것
- 왜 오너클랜 API 가 필요한가
- API 사용 신청 페이지 접속
- 신청서 작성 시 입력 항목
- 승인 후 받게 되는 인증키 종류와 보관 방법
- 오너클랜 계정이 여러 개일 때 — 모두 신청해야 하는 이유
🤔 왜 오너클랜 API 가 필요한가
일반 오너클랜 회원이 웹사이트에서 직접 발주하는 방식 대신, A-Flow 는 GraphQL API 로 직접 발주·조회·발송 매칭을 수행합니다. 이렇게 하면:
- 한 번에 수십 건을 일괄 발주 가능 (수동 1건씩 클릭 X)
- 발주 전 시뮬레이션으로 가격·재고·옵션 검증 자동화
- 발송 완료 시 송장번호 자동 매칭 → ESM 발송처리까지 자동
- 발주완료 시 메모 자동 채움 + 텔레그램 알림
API 사용에는 오너클랜이 발급하는 인증키(Username / Refresh Token) 가 필요한데, 이 글에서 신청 절차를 단계별로 설명합니다.
1️⃣ API 사용 신청 페이지 접속
오너클랜 로그인 상태에서 아래 주소로 접속합니다.
🔗 오너클랜 API 신청 페이지 바로가기또는 오너클랜 메인 → 상단 메뉴에서 API 센터 를 찾아 들어가셔도 됩니다.
2️⃣ 신청서 내용 확인
신청 페이지에서 API 사용 약관과 안내 사항을 확인합니다. API 용도, 사용 시스템, 일일 호출 예상량 같은 항목을 묻습니다.
💡 사용 목적란에는 "발주·발송 자동화 도구(A-Flow) 와 연동하여 일괄 발주 및 발송 매칭을 진행" 정도로 적으면 무난합니다.
3️⃣ 신청서 제출
모든 항목 입력 후 신청 버튼을 누르면 접수가 완료됩니다. 페이지에 "신청이 완료되었습니다" 같은 메시지가 표시되면 정상이에요.
⚠️ 신청 후 영업일 기준 1~3일 내에 승인 메일/SMS 또는 마이페이지 알림이 옵니다. 너무 늦으면 오너클랜 고객센터로 문의하세요.
4️⃣ 승인 후 인증 키 확인
승인되면 같은 API 센터 페이지에서 다음 두 가지 정보가 발급됩니다.
| 항목 | 설명 |
|---|---|
| Username | 오너클랜에서 부여한 API 사용자 식별자 (보통 본인 ID) |
| Refresh Token | API 호출 시 JWT 발급용 — 긴 문자열 (절대 외부 노출 금지) |
🚨 Refresh Token 은 비밀번호와 같습니다. 노출되면 누구나 본인 계정으로 API 호출(발주 포함) 이 가능합니다. 외부 공유 절대 금지. 만약 노출됐다면 즉시 API 센터에서 토큰 재발급.
👥 오너클랜 계정이 여러 개라면 — 전부 신청 권장
여러 계정 운영자는 모든 계정에 대해 API 신청을 받아두는 것이 좋습니다.
이유는 다음과 같습니다.
- 마켓 계정 ↔ OC 계정 1:1 매칭 — A-Flow 는 ESM/11번가 등 판매 계정별로 어느 OC 계정으로 발주할지 자동 라우팅합니다. 한 OC 계정만 등록돼 있으면 모든 발주가 그 계정으로 몰림 → 다른 OC 계정의 할인/배송정책을 못 씀
- 월 한도 분산 — OC 의 일/월 발주 한도, 결제 한도가 계정별로 적용됨. 여러 계정에 분산하면 한도 부족으로 발주 막힐 위험 줄음
- 장애 대비 — 한 계정의 API 가 일시적으로 막혀도 다른 계정으로 우회 발주 가능
- 특정 상품 전담 — 계정별로 거래하는 공급사가 다를 수 있어, 상품별로 적합한 OC 계정으로 발주 가능
신청은 계정마다 별도로 로그인해서 위 1️⃣~4️⃣ 단계를 각각 진행하면 됩니다. 한 번에 받아두면 나중에 다시 신청할 일이 없어요.
✅ 다음 단계
발급받은 Username 과 Refresh Token 을 가지고 A-Flow 에 등록하면 자동 발주·발송 기능을 바로 사용할 수 있습니다.