用途:围绕 Write.as 博客平台及其开源实现 WriteFreely 的 API 开发提供参考,适用于构建与 Write.as/WriteFreely 交互的应用、实现博文创建更新管理、配置用户认证、管理集合(博客)、跨平台发布及排查 API 调用与认证问题。
主要能力与用法:
- 发帖:匿名创建 POST https://write.as/api/posts,返回 id 与 token,务必保存 token 以便后续更新或删除;更新匿名帖同样携带 token。
- 认证:POST /api/auth/login,提交 alias 与 pass,获得 access_token,后续请求用 Authorization: Token {access_token} 头。
- 集合(博客):POST /api/collections 创建需 Pro 账户,向 /api/collections/{ALIAS}/posts 发帖,用 /api/collections/{ALIAS}/collect 将匿名帖归入集合。
- 样式:font 可选 sans、serif/norm、wrap、mono、code。
- 跨平台发布:crosspost 支持 Twitter、Tumblr、Medium。
- Markdown:POST /api/markdown,提交 raw_body 返回渲染后的 body。
- 客户端库:官方 Go、Swift、Java;社区 PHP、Python、JavaScript 等。
适用场景:博客发布工具、Markdown 编辑器集成、社交跨平台转发器、匿名博客应用、内容迁移(claim 匿名帖)。
限制:全部请求需 HTTPS;集合创建需 Pro 订阅;响应统一为 code/data 结构,常见状态码含 401、403、404、410、429;令牌属敏感凭据须妥善保存。自托管 WriteFreely 及其他价格细节暂未提供。