GET/v1/scopes
Stable2026-04-01幂等Try it

ScopeService.ListScopes

列出所有 Scope

列出所有可用的 scope,可按 category 过滤。

Authentication

无需鉴权

该接口为公共接口,可直接调用;如携带 OAuth 2.0 access_token 或 API Key 也不会被拒绝。

Request

查询参数

名称类型必填描述
categorystring—可选的 category 过滤

Response

200 OK · ListScopesResponse

字段类型必填描述
scopesarray<Scope>——

错误响应 · google.rpc.Status

非 2xx 响应均按 AIP-193 规范包装为google.rpc.Status,含 code /message /details 三段。details[].reason 是机器可读的具体错误原因码,可用于客户端分支处理。

字段类型必填描述
codeinteger (int32)—The status code, which should be an enum value of google.rpc.Code.
messagestring—A developer-facing error message.
detailsarray<Any>—A list of messages that carry the error details.

Examples

curl -X GET \
  'https://api.appforges.com/v1/scopes' \
  -H 'Authorization: Bearer $ACCESS_TOKEN'
OpenAPI spec v0.59.4 · synced 10/11/2026, 11:27:14 PM