API 接入文档
为代理客户、SaaS 集成商提供 RESTful API
v3 即将开放
加入 API Waitlist
我们正在开发 RESTful API，预计 2026 Q3 开放给 T3+ 客户。提交邮箱可获优先体验邀请。
Token 认证
JWT + API Key 双重认证。Token 在控制台一键生成，可按权限分组（只读 / 下单 / 全权）。
低延迟
P99 响应时间 < 200ms。亚太节点 CDN 加速。RPS 1000+ 不降级。
安全
所有请求 HTTPS。Webhook 用 HMAC-SHA256 签名。请求日志保留 90 天，支持审计追溯。
API 接入示例（预览）
以下接口规范可能在正式发布前调整
POST
/api/v1/orders创建发稿订单curl -X POST https://api.xingyuan.com/v1/orders \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"supplier_media_id": "sm_abc123",
"title": "AI 改变了软文行业",
"body": "...",
"category": "tech"
}'GET
/api/v1/orders/:id查询订单状态curl https://api.xingyuan.com/v1/orders/ord_xyz789 \
-H "Authorization: Bearer YOUR_API_KEY"GET
/api/v1/media?ch=portal&page=1按渠道查询媒体目录curl "https://api.xingyuan.com/v1/media?ch=portal&page=1" \
-H "Authorization: Bearer YOUR_API_KEY"POST
/api/v1/orders/batch批量创建订单curl -X POST https://api.xingyuan.com/v1/orders/batch \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"orders": [
{ "supplier_media_id": "sm_a", "title": "...", "body": "..." },
{ "supplier_media_id": "sm_b", "title": "...", "body": "..." }
]
}'SDK 计划
- • Node.js / TypeScript SDK（首发）
- • Python SDK
- • Go SDK
- • Postman Collection