试运行与测试模式

获取 API 密钥

POST /v1/posts?dry_run=true 会执行真实发布的各项检查:各网络的规则、已连接的账号、媒体、日期和你的套餐。它不会存储任何内容,也不会发出任何内容。

就绪

当每个网络都会接受该帖子时,返回 200 和 status: "ready",并为每个目标给出将用于发布的账号。

被拒绝

否则返回 422 post_refused,每个原因对应一条详情。每条详情都会指出所属网络、它的 code,并说明该如何修正。

json
{
  "error": {
    "code": "post_refused",
    "message": "The post would not be published: x: the text is too long (300 characters, at most 280)",
    "details": [
      {
        "platform": "x",
        "code": "caption_too_long",
        "max": 280,
        "actual": 300,
        "message": "x: the text is too long (300 characters, at most 280)"
      }
    ],
    "docUrl": "https://www.sofia-post.com/developers/errors#post_refused"
  }
}

所有原因都列在错误中。

测试模式

以 test 模式创建的应用(sofia_test_at_… 令牌)可以读取你真实的 Workspace,但永远不会写入:它的帖子是模拟的,并按相同规则判断,任何真实写入都会返回 403 live_mode_required。在设置 › API 中创建的密钥和客户端属于 live;如需在不发布的情况下检查,请使用试运行。