토큰 폐기

POST /v2/oauth-apps/revoke 로 액세스 토큰을 폐기해 고객 워크스페이스와의 연결을 끊는 방법이에요.

POST /v2/oauth-apps/revoke

고객이 파트너 서비스에서 페이싱크 연동을 해제하면 토큰을 폐기하세요. 요청 형식은 OAuth 2.0 토큰 폐기(RFC 7009)를 따라요.

요청 본문

본문은 application/x-www-form-urlencoded예요.

파라미터	타입	필수	설명
`token`	string	예	폐기할 액세스 토큰(`oat_...`)이에요.
`client_id`	string		앱 ID(`oap_...`)예요. HTTP Basic 인증을 쓰지 않을 때 넣어요.
`client_secret`	string		클라이언트 시크릿(`oas_...`)이에요. HTTP Basic 인증을 쓰지 않을 때 넣어요.

클라이언트 인증은 토큰 발급과 같아요.

요청 예시

curl -X POST https://api.paysync.kr/v2/oauth-apps/revoke \
  -u "$PAYSYNC_CLIENT_ID:$PAYSYNC_CLIENT_SECRET" \
  -d token="$PAYSYNC_ACCESS_TOKEN"

const res = await fetch("https://api.paysync.kr/v2/oauth-apps/revoke", {
  method: "POST",
  headers: {
    Authorization: "Basic " + Buffer.from(`${clientId}:${clientSecret}`).toString("base64"),
  },
  body: new URLSearchParams({ token: accessToken }),
});

import os
import requests

res = requests.post(
    "https://api.paysync.kr/v2/oauth-apps/revoke",
    auth=(os.environ["PAYSYNC_CLIENT_ID"], os.environ["PAYSYNC_CLIENT_SECRET"]),
    data={"token": access_token},
)

응답

클라이언트 인증에 성공하면 HTTP 200과 빈 객체가 와요.

{}

앱이 발급받은 토큰이면 그 워크스페이스와의 연결이 끊기고 토큰이 바로 멈춰요. 고객의 연결된 앱 화면에서도 사라져요.
이미 폐기했거나 모르는 토큰, 다른 앱의 토큰이어도 같은 응답이 와요. 아무 일도 하지 않아요.

오류는 { "error": "..." } 형식이에요.

{
  "error": "invalid_request"
}

{
  "error": "invalid_client"
}

오류

HTTP	`error`	발생 조건
400	`invalid_request`	본문을 `application/x-www-form-urlencoded`로 읽을 수 없어요.
401	`invalid_client`	`client_id`나 `client_secret`이 없거나 틀렸어요.