지금 요청에 쓴 키가 어느 프로젝트(쇼핑몰)에 연결돼 있는지 확인합니다. 서버 SDK 가 연동 대상을 확인하는 용도입니다.
GET /v1/projects/me
인증된 프로젝트의 정보를 조회합니다.
서버 키·비공개 키는 마스터 키(server_key:private_key)로 인증했을 때만 응답에 들어 있습니다. 서버 안에서만 쓰고, 로그나 화면에 남기지 마세요.
키 체인(clientKey:secretKey, 또는 키 체인으로 발급한 토큰)으로 인증하면 server_key·private_key 는 null 입니다. scope 가 제한된 키로 전체 권한 키를 얻을 수 없게 하기 위해서입니다.
인증
Authorization: Basic base64(clientKey:secretKey)필수 — 인증- scope 검사 없음 — 유효한 키면 호출할 수 있습니다
- 회원 JWT(
Bootpay-User-JWT): 필요 없음
요청
파라미터가 없습니다.
응답
200 OK
{
"project_id": "66a0e1b2c3d4e5f600000001",
"name": "부트커피",
"seller_name": "부트커피",
"client_key": "66a0e1b2c3d4e5f600000002",
"client_oauth_key": "...",
"server_key": "66a0e1b2c3d4e5f600000003",
"private_key": "...",
"firewall_white_ips": ["203.0.113.10"],
"domains": ["bootcoffee.example.com"],
"use_firewall": true,
"webhook_url": "https://example.com/webhook",
"webhook_retry_count": 10,
"header_content_type": 1
}json| 필드 | 타입 | 설명 |
|---|---|---|
| project_id | string | 프로젝트 ID |
| name | string | 프로젝트 이름 |
| seller_name | string | 판매자 이름 |
| client_key | string | 클라이언트 키 |
| client_oauth_key | string | 클라이언트 OAuth 키 |
| server_key | string | null | 서버 키 — 키 체인 인증이면 null |
| private_key | string | null | 비공개 키 — 키 체인 인증이면 null |
| firewall_white_ips | string[] | 허용 IP 목록 — 인증 |
| domains | string[] | 등록 도메인 |
| use_firewall | boolean | IP 보안 사용 여부 |
| webhook_url | string | 웹훅 수신 URL |
| webhook_retry_count | integer | 웹훅 재시도 횟수 |
| header_content_type | integer | 웹훅 요청 본문 형식 |
오류
공통 오류(인증·방화벽)만 있습니다 — 오류.
변경 이력
- 2026-10-19 키 체인 인증이면
server_key·private_key를null로 응답 - 2026-09-23 문서 최초 작성
