代理发布与服务目录 API
基础地址:https://aqnab.com。先创建 draft 草稿核对内容,确认后再改为 published。文档不包含真实密钥。
鉴权与权限
在「SEO优化 → 代理发布 API 密钥」生成 aqpub_ 开头的独立密钥,通过请求头 Authorization: Bearer YOUR_PUBLISHING_KEY 发送。密钥仅能管理对应站点的文章和图片,撤销立即失效,不可调用付费下单接口。下单密钥不能代替发布密钥。每分钟 30 次请求,超限返回 429 与 Retry-After: 60。
文章接口
| 方法 | 地址 | 用途 |
|---|---|---|
| GET | /api/publishing/articles?status=draft&limit=20&offset=0 | 列表:limit 1–100;status 可省略 |
| POST | /api/publishing/articles | 创建,默认草稿,返回 201 |
| GET | /api/publishing/articles/{id} | 读取完整文章与受保护预览地址 |
| PATCH | /api/publishing/articles/{id} | 局部修改,status=published 正式发布 |
| DELETE | /api/publishing/articles/{id} | 删除,公开页和 sitemap 不再展示 |
每次一篇,不支持单次批量。请求 JSON 最大 1MB,正文最多 120,000 字;标签最多 120 项、每项 180 字;标题 1–180 字;摘要最多 500 字,SEO 建议 155 字以内。
字段
title:标题;slug:新文章可选,2–150 位小写英文、数字或连字符;description:摘要;body:Markdown 正文;bodyDocument:可选 Tiptap JSON,和 body 二选一;tags:字符串数组;category:分类;platform:平台;cover:HTTPS 或站内封面图链接;language:当前仅 zh-CN;status:draft 或 published。创建时必填 title 与正文,修改可只传需要更新的字段。已有文章 slug 不可变更,避免影响收录。
Markdown 支持标题、段落、粗体、链接、列表和独立行图片,原始 HTML 不执行。返回正文统一为经过校验的 Tiptap JSON。预览需要具有该站文章权限的登录账户,草稿不会公开索引。
{
"title": "TikTok 主页链接核对指南",
"slug": "tiktok-profile-link-guide",
"description": "确认粉丝服务的主页链接,避免将视频链接误填到粉丝订单。",
"body": "## 正确格式\n使用 https://www.tiktok.com/@username,主页需要公开。\n\n\n\n## 提交前检查\n- 核对用户名\n- 核对服务数量范围",
"tags": [
"TikTok",
"主页链接"
],
"category": "下单指南",
"platform": "TikTok",
"cover": "https://example.com/cover.png",
"language": "zh-CN",
"status": "draft"
}curl -X POST https://aqnab.com/api/publishing/articles -H 'Authorization: Bearer YOUR_PUBLISHING_KEY' -H 'Content-Type: application/json' --data-binary @draft.json响应含 id、slug、status、url、preview、updatedAt。草稿 url 为 null;分站文章使用分站地址。404 表示当前密钥无此文章,409 表示试图更改已有网址。重试创建前先查列表,避免网络超时导致重复文章。
图片上传
POST /api/uploads,使用同一 Bearer 发布密钥;multipart/form-data 字段 purpose=article、files=图片文件。每次一张,仅 PNG/JPEG/WebP,最大 2MB。返回 {"ok":true,"urls":["/media/uploads/…"]}。将返回 URL 放在 cover 或 Markdown 图片中;也可直接使用外部 HTTPS 图片链接。上传不能使用其他站点的 siteId。
curl -X POST https://aqnab.com/api/uploads -H 'Authorization: Bearer YOUR_PUBLISHING_KEY' -F 'purpose=article' -F 'files=@cover.png'为文章读取本站价格
GET /api/publishing/services,使用同一 Bearer 发布密钥。主站密钥返回主站零售价,分站密钥固定返回该分站对外零售价,已包含对应销售倍率。不能通过传 site 修改站点。支持 platform、q 模糊搜索、ids(逗号分隔编号)、limit(1–100)、offset。
返回 updatedAt、site、priceBasis、currency=USD、priceUnit=per1000、total 和 services;每项含平台、服务名、pricePerThousand、最低最高数量、补量规则及下单链接。写文章时必须按每千价引用,不能写成单条价;注明查询时间,最终以实时下单页为准。分站文章请使用这个接口读取对应站点价格。
curl https://aqnab.com/api/publishing/services?q=TikTok -H 'Authorization: Bearer YOUR_PUBLISHING_KEY'公开服务目录
GET /api/public/services,无需密钥,仅返回公开零售目录,不含内部成本或上游密钥。?platform=TikTok 过滤,?format=csv 导出,JSON 返回 updatedAt 和 services。字段包含 serviceId、platform、name、pricePerThousand、currency、min、max、status、refill、refillRule、linkFormat、orderUrl。金额单位 USD/千,更新时机与目录一致。status=format_review 表示目标资料尚需核对,暂停接单;available 的 linkFormat 提供 label、example、hint、policyId 和 available。CSV 同时提供目标格式、示例与提示。
直达下单规则:/services?service=AQ3-13142。使用读取接口返回的服务 ID,服务停用后不能下单。API 下单者用 POST /api/v2、action=services 获得自己的账户报价,详情见下单指南。
