开放 API · OpenAPI

API 对接，
省心省力

媒介方与累计充值满 100 元的会员申请 API Token 后，即可程序化对接 媒体资源、发布订单 与 AI 报告——自动查询刊例、批量下单、实时追踪发布回链，还能直接提交 SEO / 外贸 / GEO 等报告需求并取回结果。

会员登录申请媒介方入口查看接口文档

curl

$ curl -H "Authorization: Bearer pr1_xxx" \
   http://www.pr1.cn/openapi/v1/media?type=media

{ "code":0, "data":{ "list":[ … ], "total":128 } }

能做什么

一套接口，打通媒体与订单

媒体资源查询

按类型 / 频道 / 行业 / 地区筛选新闻媒体、自媒体、短视频、海外媒体，价格按你的会员等级实时返回。

程序化下单

指定媒体 + 稿件一键下单，余额自动结算并派发履约，无需登录后台手动操作。

订单与回链追踪

实时查询订单状态与每篇稿件的发布回链，轻松接入你自己的系统与报表。

AI 报告直连

程序化提交 SEO / 外贸 / GEO / 商业计划书等报告需求，余额结算、进度可查、完成后回传报告链接。

字段自描述

报告产品的表单字段由接口自身返回（含必填标记），无需硬编码，产品调整后你的对接无需改代码。

统一余额结算

发布与报告共用账户余额，按会员等级计价；参数校验不通过的请求不创建订单、不扣费。

如何开通

四步拿到你的 API Token

登录账号

累计充值满 100 元的会员，或已开通的媒介方账号。

提交申请

会员中心 / 媒介门户的「API 接口」一键申请。

审核开通

管理员审核通过后签发专属 Token。

开始对接

带上 Token 调用接口，立即自动化。

接口文档

OpenAPI v1

所有接口统一鉴权：请求头 Authorization: Bearer <你的Token>（也支持 ?token=）。返回 {"code":0,"data":…}，code 非 0 为错误。

方法	路径	说明
GET	/openapi/v1/ping	校验令牌，返回归属信息
GET	/openapi/v1/media	媒体列表（type/channel/industry/city/kw/page）
POST	/openapi/v1/orders	下单（goods_type, goods_id, article_title, article_content）· 仅会员
GET	/openapi/v1/orders	我的订单列表 · 仅会员
GET	/openapi/v1/orders/{no}	订单详情 + 明细（含状态与回链）· 仅会员
AI 报告
GET	/openapi/v1/ai-reports/products	可下单的报告产品与其表单字段（含必填标记）
POST	/openapi/v1/ai-reports	提交报告需求（product_id, fields）· 仅会员
GET	/openapi/v1/ai-reports	我的报告订单列表 · 仅会员
GET	/openapi/v1/ai-reports/{no}	报告订单详情（状态 + 报告链接）· 仅会员

下单示例

curl -X POST http://www.pr1.cn/openapi/v1/orders \
  -H "Authorization: Bearer pr1_你的Token" \
  -H "Content-Type: application/json" \
  -d '{"goods_type":"media","goods_id":123,"article_title":"标题","article_content":"正文内容…"}'

goods_id 须为 JSON 数字类型（如 123），传成字符串（如 "123"）会被判定为参数错误
下单仅限累计充值满 100 元的会员令牌调用；参数错误的请求不会创建订单、不扣费

订单详情响应示例（GET /openapi/v1/orders/{no}）

{
  "code": 0,
  "data": {
    "order": { "order_number": "PR...", "order_state": 1, "order_paid": 7.00, ... },
    "items": [
      {
        "status": 1,
        "backlink": "",
        "article_url": "",
        "refund_state": 0,
        "fail_reason": ""
      }
    ]
  }
}

明细在 data.items 数组中（非扁平结构），一个订单可含多条稿件明细
status 为数字状态码（非字符串）：0 待支付 / 1 处理中 / 2 已发布 / 3 发布失败 / 4 已退款
backlink 稿件实际发布上线后才会回填，发布前为空字符串属正常状态

AI 报告接口

新增

与站内「AI 智能报告」同一套下单与计费：提交需求后自动生成，完成后回写报告链接。报告由 aireport.store（智研 Max）生成，你只需对接本站接口，无需自行申请对方账号。

① 取产品与字段定义

curl -H "Authorization: Bearer pr1_你的Token" \
  http://www.pr1.cn/openapi/v1/ai-reports/products

{ "code":0, "data": { "list": [
  { "product_id":1, "biz_type":1, "name":"深度网站SEO分析报告", "price":200,
    "fields":[ {"key":"url","label":"目标网址","required":true},
               {"key":"keywords","label":"核心关键词（3–20 个）","required":true} ] } ] } }

② 提交报告需求（余额扣款）

curl -X POST http://www.pr1.cn/openapi/v1/ai-reports \
  -H "Authorization: Bearer pr1_你的Token" \
  -H "Content-Type: application/json" \
  -d '{"product_id":1,"fields":{"url":"https://example.com","keywords":"外贸 SEO"}}'

{ "code":0, "msg":"下单成功，报告生成中",
  "data":{ "order_no":"AI1786261476088870", "amount":200,
           "status":1, "status_text":"queued", "report_url":"" } }

③ 轮询进度 / 取回报告

curl -H "Authorization: Bearer pr1_你的Token" \
  http://www.pr1.cn/openapi/v1/ai-reports/AI1786261476088870

{ "code":0, "data":{ "status":3, "status_text":"completed",
  "report_url":"https://aireport.store/r/xxxx" } }

fields 的键用 products 返回的 key（英文）或 label（中文）均可，便于不同语言的系统对接
status：1 待生成 / 2 生成中 / 3 已完成 / 4 生成失败 / 5 已退款；同时返回英文 status_text 便于判断
必填字段缺失或 product_id 无效时直接报错，不创建订单、不扣费；报告费用与站内一致，按 products 返回的 price 从余额扣除
建议轮询间隔 ≥30 秒；生成通常分钟级完成，完成后 report_url 才有值
若管理员尚未在后台启用 AI 报告接口，订单会停在「待生成」等待人工处理，费用照常已扣、可申请退款

让对接，省心省力

媒介方与充值满 100 元的会员，现在就申请 API 权限，把发布与监控接进你的系统。

会员登录申请媒介方入口

API 对接，省心省力