DEV.to

概览

提供商 ID 为 devto。DEV.to 使用通过 api-key 请求头发送的个人 API 密钥，而不是 OAuth 流程。文章通过一次 POST https://dev.to/api/articles 调用创建，正文来自显式 body_markdown 选项，而不是共享文本。

要求

• 一个 DEV.to 账号及其个人 API 密钥。
• 你希望发布的标题和 Markdown 正文。

未解决。面向用户的 API 密钥签发和重新生成步骤尚未在一手文档页面确认，因此本指南不提供设置路径。

凭证

通过读取 GET /api/users/me 验证密钥：密钥有效时返回 200 和用户信息，被拒绝时返回 401。

连接

export SYNDROO_CREDENTIALS='{"apiKey":"DEV_TO_API_KEY_PLACEHOLDER"}'
syndroo connect devto --from-env --label writing

该提供商没有连接选项：凭证字段就是全部连接输入。

首次发布

文章目标不需要共享内容，因为文章自带标题和正文：

{
  "type": "prepare",
  "content": {},
  "targets": [
    {
      "provider": "devto",
      "options": {
        "title": "Publishing from the terminal",
        "body_markdown": "# Hello\n\nSyndroo sends this article.",
        "tags": ["devtools"],
        "canonical_url": "https://example.com/posts/terminal"
      }
    }
  ]
}

syndroo publish --input post.json --json

提供商会发送 published: true；未发布的草稿不是该目标的默认行为。文章创建后发生超时，客户端无法获知文章 ID，因此结果保持 unknown，并且不可重试。

能力

清单声明 article。未解决。已获取的 API 参考没有说明标题的准确上限和 v1 速率限制，因此本页不提供数字，提供商也不强制执行。

选项

故障排除

密钥被拒绝时返回 401，验证失败时返回 422 并带有错误字符串，触发速率限制时返回 429。提供商不会重试其中任何一种情况，也不会虚构范围字符串：DEV.to 没有为该密钥记录任何 OAuth 范围。

撤销与安全

未解决。API 参考尚未确认密钥重新生成和撤销步骤，因此本指南不作断言。安全的本地步骤是在 DEV.to 账号设置中重新生成或删除密钥，然后断开本地连接：

syndroo connect --disconnect <connectionId>