full/wiki/api/01-ads.md

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: <JWT> 传递裸 JWT，不添加 Bearer 前缀。
• 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 code、message、details。

服务概览

服务	方法数	说明
Fetch	1	Fetch 服务

Fetch

方法	动态 HTTP 路径	请求	响应	类型
ByPos	POST /rpc/ads/Fetch/ByPos	ads.ByPosRequest	ads.ByPosReply	Unary

Fetch.ByPos

• 动态 HTTP：POST /rpc/ads/Fetch/ByPos
• gRPC：/ads.Fetch/ByPos
• 请求示例：

{
  "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	可选