认证

API 根地址为 https://api.temporam.com,所有端点均以 /v3 开头。

认证

在工作台创建 API Key,并在每个请求中发送 Bearer Token:

  1. 1curl https://api.temporam.com/v3/domains \
  2. 2 -H "Authorization: Bearer YOUR_API_KEY" \
  3. 3 -H "Accept: application/json"

不要把密钥放入浏览器客户端、公开仓库或日志。

通用响应

成功响应通常由 data 与 meta 组成。meta.remaining 表示该请求后剩余可用额度;列表响应还带有 total、page 和 limit。

  1. 1{
  2. 2 "data": [],
  3. 3 "meta": {
  4. 4 "remaining": 100
  5. 5 }
  6. 6}

失败时返回 error.type、error.code、error.message,并可能包含 error.param。客户端应根据 HTTP 状态码和 error.code 处理错误,不要依赖英文消息文本。

  1. 1{
  2. 2 "error": {
  3. 3 "type": "api_error",
  4. 4 "code": "invalid_request",
  5. 5 "message": "Invalid request",
  6. 6 "param": "email"
  7. 7 }
  8. 8}