애플리케이션 API 권한 부여 설정

PUT /v1/applications/{application_id}/api-grants/{api_id} · 권한 applications:write

애플리케이션이 한 API에 대해 요청할 수 있는 범위를 전체적으로 대체합니다. 애플리케이션은 최대 50개 API에 대한 권한 부여를 보유할 수 있습니다.

요청

매개변수 In 설명
application_id path 애플리케이션 id(app_…).
api_id path API id(api_…).

Body

필드 유형 필수 설명
scopes string[] 예 허용된 범위(resource:action). 각각은 API에서 정의되어야 합니다. 최대 1000개.
default_scopes string[] 아니오 기본적으로 부여된 범위. scopes의 부분집합입니다.

응답

200 OK와 권한 부여.

{
  "application_id": "app_6f8d0cjgbmf0gtn2rg6pscp3cg",
  "api_id": "api_0000000000000000000000001z",
  "scopes": ["orders:read", "orders:write"],
  "default_scopes": ["orders:read"],
  "created_at": "2026-10-05T10:00:01Z",
  "updated_at": "2026-10-05T10:00:01Z"
}

오류

HTTP code 조건
401 unauthenticated 키가 누락되었거나, 유효하지 않거나, 취소되었습니다.
403 insufficient_permissions 키에 필요한 권한이 없습니다.
404 not_found 이 환경에서 애플리케이션이나 권한 부여가 존재하지 않습니다.
422 validation_failed 범위가 잘못되었거나 API에서 정의되지 않았거나, default_scopes가 scopes의 부분집합이 아닙니다.
403 quota_exceeded 애플리케이션이 이미 50개 API에 대한 권한 부여를 보유합니다.
400 unknown_field 본문에 스키마에 없는 필드가 있습니다.

예제

curl -X PUT https://api.eu.keenauth.com/v1/applications/app_6f8d0cjgbmf0gtn2rg6pscp3cg/api-grants/api_0000000000000000000000001z \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scopes":["orders:read","orders:write"],"default_scopes":["orders:read"]}'