프로젝트

지금 요청에 쓴 키가 어느 프로젝트(쇼핑몰)에 연결돼 있는지 확인합니다. 서버 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 문서 최초 작성

함께 보기