ScopeService.GetScope
获取 Scope
按名称查询单个 scope。
Authentication
无需鉴权
该接口为公共接口,可直接调用;如携带 OAuth 2.0 access_token 或 API Key 也不会被拒绝。
Request
路径参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
name | string | yes | Scope name, e.g. "creative:read" |
Response
200 OK · GetScopeResponse
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
scope | Scope | — | — |
错误响应 · google.rpc.Status
非 2xx 响应均按 AIP-193 规范包装为google.rpc.Status,含 code /message /details 三段。details[].reason 是机器可读的具体错误原因码,可用于客户端分支处理。
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
code | integer (int32) | — | The status code, which should be an enum value of google.rpc.Code. |
message | string | — | A developer-facing error message. |
details | array<Any> | — | A list of messages that carry the error details. |
Examples
curl -X GET \
'https://api.appforges.com/v1/scopes/{name}' \
-H 'Authorization: Bearer $ACCESS_TOKEN'OpenAPI spec v0.59.4 · synced 10/11/2026, 11:27:14 PM