📘 阳光标讯 开放 API

// 方式 1：Header（推荐）
X-API-Key: sk-abc123def456

// 方式 2：Authorization Bearer
Authorization: Bearer sk-abc123def456

// 方式 3：查询参数（不推荐）
GET /api/v1/bids?api_key=sk-abc123def456

{
  "code": 0,
  "message": "success",
  "data": { /* 业务数据，可为 null */ }
}

{
  "items": [],
  "pagination": {
    "total": 1000,
    "page": 1,
    "pageSize": 20,
    "totalPages": 50
  }
}

分页查询招标/中标公告，支持多维度筛选与排序。

请求参数（Query）：

参数	类型	必填	默认值	说明
page	int	否	1	页码
pageSize	int	否	20	每页条数，最大 100
keyword	String	否	—	关键词（标题/内容/采购单位名）
province	String	否	—	省份，如"广东"
city	String	否	—	城市，如"深圳"
industry	String	否	—	行业
category	String	否	—	分类：工程/服务/货物
bid_type	String	否	—	招标公告/中标公告/变更公告
bidding_method	String	否	—	招标方式
buyer_type	String	否	—	采购单位类型
publish_date_start	String	否	—	发布起始日期 yyyy-MM-dd
publish_date_end	String	否	—	发布结束日期 yyyy-MM-dd
sort_by	String	否	publish_date	排序字段
sort_order	String	否	desc	排序方向 asc/desc

响应示例：

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "id": 10001,
        "title": "XX 项目招标公告",
        "buyer": "XX 单位",
        "budget": "100 万元",
        "bidding_method": "公开招标",
        "industry": "建筑",
        "province": "甘肃",
        "city": "兰州",
        "winner": "XX 公司",
        "win_amount": "98 万元",
        "publish_date": "2026-07-19T10:00:00"
      }
    ],
    "pagination": { "total": 1037, "page": 1, "pageSize": 20, "totalPages": 52 }
  }
}

查询单条标讯的完整详情，含章节、附件、招标方/中标方联系方式。

参数	位置	类型	必填	说明
bidId	Path	Long	是	标讯 ID

响应字段：含 title、content、buyer、buyer_contact、agent、budget、winner、win_amount、open_bid_time、doc_get_time、sections[]、attachments[]、parent_bid、child_bids[]。

平台标讯总量、今日新增、覆盖省份数、收录企业数。

{
  "code": 0,
  "data": {
    "total": 1250000,
    "today": 3862,
    "total_sources": 120,
    "total_companies": 380000
  }
}

返回所有可用筛选项（省份、行业、招标方式、采购单位类型等），便于前端下拉选择。

用户查看标讯详情时上报浏览行为。登录用户首次查看会扣积分（同一标讯仅扣一次）。

响应字段：

字段	类型	说明
bidId	Long	标讯 ID
loggedIn	Boolean	是否已登录
deducted	Boolean	本次是否真扣了积分
balance	Integer	当前积分余额
viewBidCost	Integer	查看一条标讯消耗的积分数

下载标讯附件（招标文件、图纸等），需登录用户或 API Key。

参数	类型	必填	说明
keyword	String	是	公司名关键词
limit	int	否	返回数量（默认 10）

分页列出所有采购单位（招标方），支持关键词和类型过滤。

参数	类型	必填	说明
keyword	String	否	采购单位名关键词
buyer_type	String	否	采购单位类型
page	int	否	页码（默认 1）
page_size	int	否	每页条数（默认 15）

参数	位置	类型	必填	说明
username	Body	String	是	用户名（手机号）
password	Body	String	是	密码（8-20 位，含字母+数字）
smsCode	Body	String	否	短信验证码（手机号注册时）
inviteCode	Body	String	否	邀请码（双方各得 1 积分）

参数	位置	类型	必填	说明
username	Body	String	是	用户名 / 手机号 / 邮箱
password	String	是	密码

响应：登录态写入 HttpOnly Cookie bid_auth，同时返回 token 字段供小程序使用。

参数	位置	类型	必填	说明
phone	Body	String	是	手机号
purpose	Body	String	是	用途：register / reset / bind

微信小程序登录，code 为 wx.login() 返回值。

参数	位置	类型	必填	说明
code	Body	String	是	wx.login() 返回的 code
nickname	Body	String	否	微信昵称
avatar	Body	String	否	微信头像 URL

参数	位置	类型	必填	说明
phone	Body	String	是	手机号
smsCode	Body	String	是	短信验证码
newPassword	Body	String	是	新密码

返回当前用户资料（手机号、邮箱、昵称等已脱敏）。

返回当前积分余额、累计收入/支出、签到状态。

列出当前用户所有关键词订阅（标题/采购方/地区等）。

创建关键词订阅。Body 含 keyword、frequency（daily/weekly）、channels（email/wechat_mp/miniapp）。

列出监控中的企业（招标方或中标方），匹配新标讯会推送。

响应：含每个 Key 的名称、Key ID（脱敏）、状态、限流设置、累计调用次数、最后使用时间。

参数	位置	类型	必填	说明
name	Body	String	是	Key 名称（仅自己可见）
rateLimitPerHour	Body	int	否	每小时限流（默认 500）
ipWhitelist	Body	String[]	否	IP 白名单，空数组=不限

切换 Key 状态（active ↔ disabled），停用后该 Key 所有调用立即返回 401。

删除 Key（不可恢复）。

查询参数：days（默认 7）

响应：每日调用次数、扣分总数、按端点的调用分布。

参数	位置	类型	必填	说明
packageId	Body	Long	是	套餐 ID
payMethod	Body	String	否	wechat / virtual（小程序虚拟支付）

响应：返回 orderId 和微信支付参数（prepay_id、签名等）。

响应：status（pending/paid/closed）、points、paidAt。