API 概述与规范

开发者 API 提供了一套遵循 RESTful 风格的 HTTP 接口,用于通过编程方式管理账户统计、计费数据及关键词监控任务。

基础信息

所有 API 请求必须基于 HTTPS 协议,数据交互格式为 JSON。

  • Base URL: https://www.fashionbashusa.com
  • 数据返回格式: 所有接口均返回 JSON(截图二进制流接口除外),包含 success 布尔值字段指示请求状态。

鉴权方式 (Authentication)

API 采用 API Key 机制进行永久身份鉴权。每次请求需将您的密钥置于 HTTP 请求头的 Authorization 字段中,并使用 Bearer 前缀。

获取密钥与安全性

API Key 作为您的唯一凭证,具备永久有效性(除非您在控制台中主动撤销)。您可以前往 「账号设置」 -「API 密钥」生成专属于您的 Key。请务必妥善保管,切勿在前端代码或公共仓库中泄露,否则可能导致账户资金被滥用。遇到 401 Unauthorized,请检查密钥是否正确或是否被禁用。

开发者沙盒与特性

为了帮助您更快地完成系统集成,我们的开发者文档内置了以下高级交互特性:

  • 在线 API Playground(测试控制台)

    每个 API 详情页都配备了真实的在线测试沙盒。您可以直接在页面中修改请求参数、Headers 或 JSON Body,点击运行即可实时查看真实的后端响应,让调试变得极其简单。

  • 多语言开箱即用代码示例

    测试控制台内部会根据您填写的参数,自动实时生成多语言的集成代码(完整支持 cURL、Python、Node.js、Go 和 Rust)。只需一键复制,即可无缝接入您的业务环境。

Header 格式规范
1Authorization: Bearer ts_live_YOUR_API_KEY