v1 开发者与 AI 工具

PostJe API

从 ChatGPT、Claude、n8n、Make、Zapier 或您自己的程序提交帖子。您提交的每个帖子都会以“pending_approval”状态进入，只有在 PostJe 中获得批准后才会发布。

身份验证

PostJe 为配套包含 API 访问的公司签发 API 密钥。向我们申请密钥后，以 Bearer 令牌发送。请始终发送 Accept: application/json。

Authorization: Bearer YOUR_API_KEY
Accept: application/json

接口

GET

https://postje.social/api/v1/accounts

列出已连接的社交账户。创建帖子时使用其 id 值。 posts:read

GET

https://postje.social/api/v1/posts

列出帖子，最新的在前，每页 20 个。可选 ?status=pending_approval|approved|published|failed… posts:read

POST

https://postje.social/api/v1/posts

创建帖子，它会在 PostJe 中等待审批。 posts:write

GET

https://postje.social/api/v1/posts/{id}

单个帖子，发布后包括各平台的结果和链接。 posts:read

DELETE

https://postje.social/api/v1/posts/{id}

删除尚未批准的帖子。 posts:write

创建帖子

caption	string	帖子文字。Instagram 最多 2,200 个字符，Threads 最多 500 个字符。
accounts	array of ids	必填。来自 GET /accounts 的账户 ID。
media_urls	array of URLs	选填。最多 10 个公开的图片（JPG/PNG/WebP）或视频（MP4）网址，PostJe 会自动下载。
media[]	files	选填。可用 multipart/form-data 直接上传文件，而不是提供网址。
scheduled_at	ISO 8601	选填。批准后的发布时间。不填则在批准后立即发布。
client	string	选填。工具名称，会显示给审批人（默认为 API 密钥名称）。

curl -X POST https://postje.social/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" -H "Content-Type: application/json" \
  -d '{
    "caption": "New arrivals are in! Visit us this weekend.",
    "accounts": ["9b1d6c1e-…", "9b1d6c2f-…"],
    "media_urls": ["https://example.com/photo.jpg"],
    "scheduled_at": "2026-11-01T10:00:00+08:00",
    "client": "ChatGPT"
  }'

响应：201，并返回帖子，状态为“pending_approval”。验证问题（例如 Instagram 没有图片）会返回 422，并附上每个字段的说明。

限额

每个密钥每分钟 60 次请求。
帖子会计入配套的每月帖子限额。
包含“API 访问”功能的配套提供 API 访问。