서비스와 개발을
더 빠르게 잇습니다.
잇점 Partner API로 쇼핑·게시판 데이터를 서드파티 앱에서 사용하세요. 앱 신청부터 OAuth·문서·OpenAPI까지 한곳에서 이어집니다.
# OAuth 토큰 (client_credentials)
curl -sS -X POST 'https://api.itjeom.com/partner/v1/oauth/token' \
-H 'Content-Type: application/json' \
-d '{
"grant_type": "client_credentials",
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET",
"scope": "shop:read board:read"
}'
$payload = [
'grant_type' => 'client_credentials',
'client_id' => getenv('ITJEOM_CLIENT_ID'),
'client_secret' => getenv('ITJEOM_CLIENT_SECRET'),
'scope' => 'shop:read board:read',
];
$ch = curl_init('https://api.itjeom.com/partner/v1/oauth/token');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);
const res = await fetch('https://api.itjeom.com/partner/v1/oauth/token', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
grant_type: 'client_credentials',
client_id: process.env.ITJEOM_CLIENT_ID,
client_secret: process.env.ITJEOM_CLIENT_SECRET,
scope: 'shop:read board:read',
}),
});
const token = await res.json();
{ "access_token": "…", "token_type": "Bearer", "expires_in": 3600 }
필요한 기능부터
바로 시작하세요.
인증·쇼핑·게시판·콘솔·스펙을 카드로 나눴습니다. 각 항목은 문서·OpenAPI·콘솔로 이어집니다.
인증 · OAuth
client_credentials · refresh_token으로 Bearer JWT를 발급합니다. 브라우저에 secret을 두지 마세요.
커머스 API
상품 목록·단건 조회와 주문 생성. 스코프 shop:read · shop:order:write.
게시판 API
보드별 글 목록·단건. 스코프 board:read · 쿼리 board= 슬러그.
개발자 콘솔
허브 로그인 후 API 앱 신청. 승인되면 client_id · client_secret 발급.
콘솔 열기 → 05레시피
토큰 · 쇼핑 · 게시판 · 회원 가입·로그인(외부 AI/앱용).
회원 가입·로그인 → 06전체 OpenAPI
엔드포인트·필드·오류 코드를 스펙으로 확인합니다.
세 단계면
연결됩니다.
developers.itjeom.com/console
새 API 앱
허브 계정으로 로그인한 뒤 앱 이름·API 사용 도메인·요청 스코프를 넣고 신청합니다. 검토 후 승인되기 전까지 secret은 발급되지 않습니다.
콘솔로 이동Settings / credentials
client_id · client_secret
승인 완료 후 콘솔에 표시됩니다. 환경 변수로만 주입하고 프론트·저장소에 커밋하지 마세요.
ITJEOM_CLIENT_ID / ITJEOM_CLIENT_SECRET
curl -sS 'https://api.itjeom.com/partner/v1/shop/products?page=1&per_page=20' \ -H 'Authorization: Bearer ACCESS_TOKEN' \ -H 'Accept: application/json'
문서를 읽는 시간을 줄이고,
구현에 집중하세요.
cURL·PHP 예제, OpenAPI, 토큰 갱신 레시피, health 엔드포인트를 한 흐름에 두었습니다.
- ⌘언어별 샘플examples/ · /recipes
- ◎OpenAPI/openapi/ · /page/partner_openapi
- ●헬스 체크GET /partner/v1/meta/health
Base URL
https://api.itjeom.com/partner/v1
JWT 클레임 (요약)
- aud = partner
- scopes = 승인된 스코프
- 관리자·허브 JWT와 분리
Partner API v0.2 라이브
oauth/token · shop · board · console/apps · meta/health
만료 refresh 토큰 정리
D1에서 만료된 partner refresh 토큰을 삭제합니다.
관리자 API와 분리
/partner/v1 만 사용하세요. 스토어 공개 URL·admin JWT는 Partner 계약이 아닙니다.