64 lines
1.5 KiB
Markdown
64 lines
1.5 KiB
Markdown
# ADS API
|
||
|
||
广告获取与投放内容读取。
|
||
|
||
> 本文档由 protobuf descriptor 生成。字段名采用 protobuf JSON 名称；64 位整数在 JSON 中应按字符串处理。
|
||
|
||
## 接入方式
|
||
|
||
- 动态 HTTP：`POST /rpc/ads/{Service}/{Method}`
|
||
- 原生 gRPC：`/ads.{Service}/{Method}`
|
||
- grpc-gateway：`POST /ads.{Service}/{Method}`
|
||
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
|
||
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
|
||
|
||
## 服务概览
|
||
|
||
| 服务 | 方法数 | 说明 |
|
||
|---|---:|---|
|
||
| `Fetch` | 1 | Fetch 服务 |
|
||
|
||
## Fetch
|
||
|
||
| 方法 | 动态 HTTP 路径 | 请求 | 响应 | 类型 |
|
||
|---|---|---|---|---|
|
||
| `ByPos` | `POST /rpc/ads/Fetch/ByPos` | [`ads.ByPosRequest`](#adsbyposrequest) | [`ads.ByPosReply`](#adsbyposreply) | Unary |
|
||
|
||
### Fetch.ByPos
|
||
|
||
- 动态 HTTP：`POST /rpc/ads/Fetch/ByPos`
|
||
- gRPC：`/ads.Fetch/ByPos`
|
||
- 白名单键：`ads.Fetch.ByPos`
|
||
- 请求示例：
|
||
|
||
```json
|
||
{
|
||
"key": "string"
|
||
}
|
||
```
|
||
|
||
## 消息结构
|
||
|
||
### ads.AdsItem
|
||
|
||
| JSON 字段 | 类型 | 规则 |
|
||
|---|---|---|
|
||
| `id` | `int64` | 可选 |
|
||
| `title` | `string` | 可选 |
|
||
| `content` | `string` | 可选 |
|
||
| `type` | `int32` | 可选 |
|
||
| `toUrl` | `string` | 可选 |
|
||
| `created` | `string` | 可选 |
|
||
|
||
### ads.ByPosReply
|
||
|
||
| JSON 字段 | 类型 | 规则 |
|
||
|---|---|---|
|
||
| `data` | `[]ads.AdsItem` | 数组 |
|
||
|
||
### ads.ByPosRequest
|
||
|
||
| JSON 字段 | 类型 | 规则 |
|
||
|---|---|---|
|
||
| `key` | `string` | 可选 |
|