01
注册账户
免费注册后进入控制台。
API Docs
HTTPS + JSON,按次计费,失败不扣费。Base URL:https://www.xmedi.cn/api/v1。机器可读契约: openapi.json
X-XMEDI-Key: xm_live_…(也可用 ?key= 或请求体 key 字段)。Key 只放在服务端,不要写进前端或公开仓库。code = 0 才扣费;参数错误、平台取数失败、超时均不扣费。meta 带 request_id、本次扣费 cost_fen(分)与余额 balance_fen。排查问题时请提供 request_id。curl -X POST https://www.xmedi.cn/api/v1/wechat/search/articles \
-H "X-XMEDI-Key: xm_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"keyword":"品牌名"}'{
"code": 0,
"message": "ok",
"data": { "items": [ ... ] },
"meta": {
"request_id": "0b6f…",
"cost_fen": 15,
"balance_fen": 9985
}
}加载中…
失败时 HTTP 状态码非 200,code 非 0,error_code 为稳定字符串,可用于程序判断。
| code | error_code | HTTP | 说明 |
|---|---|---|---|
| 40001 | VALIDATION_ERROR | 400 | 参数缺失或格式错误,data.details 给出字段 |
| 40100 | UNAUTHORIZED | 401 | API Key 缺失、无效或已吊销 |
| 40200 | INSUFFICIENT_BALANCE | 402 | 余额不足,充值后重试 |
| 40400 | NOT_FOUND | 404 | 接口路径不存在 |
| 42900 | RATE_LIMITED | 429 | 超过该接口每分钟调用上限 |
| 50200 | UPSTREAM_ERROR | 502 | 平台侧取数失败或超时,可稍后重试;不扣费 |
| 50300 | NOT_AVAILABLE | 503 | 接口暂不可用;不扣费 |
您的业务、看板或 Agent 通过 HTTPS 调用。
API Key 鉴权、按次计量、限流与统一字段契约。
平台能力分层选路,保障微信等场景的实时性。