키 발급 스코프 목록

키 생성·조회 로 하위 프로젝트 키를 만들 때 api_scopes 에 넣을 스코프 id 를 돌려준다. 결제(PG) 키와 커머스 키는 스코프가 다르므로 target 으로 나눠 부른다.

핵심 요약

• api_scopes 에는 이 목록의 api_scope_id 를 넣는다. key·name 은 사람이 고를 때 보는 값이다.
• 사용 중인 스코프만 나온다. 같은 그룹끼리 묶여 그룹 순서 → 스코프 순서로 온다.
• 모든 리셀러가 같은 목록을 본다. 자주 바뀌지 않으므로 받아 두고 써도 된다.
• 리셀러 API 자체를 부르는 범위 키(reseller:* 스코프)는 범위 키(리셀러 스코프) 를 본다. 이 문서는 하위 프로젝트 키용 목록이다.

API 정보

요청 파라미터

코드 예제

import fetch from 'node-fetch'

const RESELLER_AUTH = 'Basic ' + Buffer
  .from(`${process.env.BOOTPAY_RESELLER_CLIENT_KEY}:${process.env.BOOTPAY_RESELLER_SECRET_KEY}`)
  .toString('base64')

const res = await fetch('https://api.bootpay.co.kr/v2/reseller/scopes?target=pg', {
    headers: { 'Authorization': RESELLER_AUTH }
})
const { list } = await res.json()
const readOnly = list.filter(scope => scope.key.endsWith(':read')).map(scope => scope.api_scope_id)
// readOnly 를 키 발급(POST /v2/reseller/seller/app/key-chain)의 api_scopes 에 넣는다javascript

import base64, os, requests

auth = 'Basic ' + base64.b64encode(
    f"{os.environ['BOOTPAY_RESELLER_CLIENT_KEY']}:{os.environ['BOOTPAY_RESELLER_SECRET_KEY']}".encode()
).decode()

res = requests.get('https://api.bootpay.co.kr/v2/reseller/scopes', params={'target': 'commerce'}, headers={'Authorization': auth})
print([(s['key'], s['api_scope_id']) for s in res.json()['list']])python

RESELLER_AUTH=$(printf '%s' "$BOOTPAY_RESELLER_CLIENT_KEY:$BOOTPAY_RESELLER_SECRET_KEY" | base64)

curl "https://api.bootpay.co.kr/v2/reseller/scopes?target=pg" -H "Authorization: Basic $RESELLER_AUTH"bash

응답

{
  "target": "pg",
  "list": [
    {
      "api_scope_id": "6098a1b2c3d4e5f600000301",
      "key":          "receipt:read",
      "name":         "결제 조회",
      "description":  "결제 단건·목록 조회",
      "group_key":    "payment",
      "group_name":   "결제"
    }
  ]
}json

에러 코드