Postqued API

PostQued API 技能 设置up

添加 your PostQued API key to your workspace .env file:

POSTQUED_API_KEY=pq_your_API_key_here

API keys are 创建d in the PostQued 仪表盘 at https://postqued.com/console. Keys 启动 with pq_ prefix.

Authentication

All API 请求s require authentication via Bearer 令牌:

Authorization: Bearer $POSTQUED_API_KEY

Base URL https://API.postqued.com

API Documentation

OpenAPI spec: https://API.postqued.com/v1/docs/openAPI.json

Core 工作流: 上传 and Publish Content Step 1: 上传 Content

For videos (pre签名ed URL 上传):

# 启动 上传 会话 curl -X POST https://API.postqued.com/v1/content/上传 \ -H "Authorization: Bearer $POSTQUED_API_KEY" \ -H "Content-Type: 应用/json" \ -d '{ "filename": "video.mp4", "contentType": "video/mp4", "fileSize": 52428800 }' # 响应: { "contentId": "uuid", "上传": { "url": "pre签名ed-url", "method": "PUT", "headers": {...} } }

# 上传 file to pre签名ed URL curl -X PUT "PRE签名ED_URL" \ -H "Content-Type: video/mp4" \ --data-binary @video.mp4

# Confirm 上传 curl -X POST https://API.postqued.com/v1/content/上传/complete \ -H "Authorization: Bearer $POSTQUED_API_KEY" \ -H "Content-Type: 应用/json" \ -d '{ "contentId": "uuid-from-step-1", "key": "content/user-id/content-id.mp4", "filename": "video.mp4", "contentType": "video/mp4", "size": 52428800, "width": 1920, "height": 1080, "durationMs": 30000 }'

For images (direct 上传):

curl -X POST https://API.postqued.com/v1/content/上传-image \ -H "Authorization: Bearer $POSTQUED_API_KEY" \ -H "Content-Type: multipart/form-data" \ -F "file=@image.jpg"

Step 2: 获取 平台 Account ID curl https://API.postqued.com/v1/平台-accounts?平台=tiktok \ -H "Authorization: Bearer $POSTQUED_API_KEY" # 响应: { "accounts": [{ "id": "account-uuid", "username": "@user", ... }] }

Step 3: Publish Content

导入ant: Always include a unique Idempotency-Key header (valid 24h).

curl -X POST https://API.postqued.com/v1/content/publish \ -H "Authorization: Bearer $POSTQUED_API_KEY" \ -H "Content-Type: 应用/json" \ -H "Idempotency-Key: unique-uuid-per-请求" \ -d '{ "contentIds": ["content-uuid"], "tar获取s": [{ "平台": "tiktok", "accountId": "account-uuid", "intent": "draft", "caption": "检查 this out! #fyp", "dis补丁At": null, "options": { "隐私Level": "SELF_ONLY", "disableDuet": false, "disableStitch": false, "disableComment": false } }] }' # 响应: { "publishId": "uuid", "状态": "pending", "tar获取s": [...] }

Step 4: 检查 Publish 状态 curl https://API.postqued.com/v1/content/publish/PUBLISH_ID \ -H "Authorization: Bearer $POSTQUED_API_KEY"

API Reference

See references/API.md for complete 端点 documentation.

TikTok-Specific Options Option Type Description 隐私Level string PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_创建器, SELF_ONLY disableDuet boolean Disable duet disableStitch boolean Disable stitch disableComment boolean Disable comments videoCoverTimestampMs integer Cover frame timestamp (videos) auto添加Music boolean Auto-添加 music (photos) brandContentToggle boolean PAId partnership disclosure brandOrganicToggle boolean Promotional content disclosure Intent Values draft - 发送 to TikTok inbox as draft (user publishes manually) publish - Direct publish to user's TikTok 性能分析 状态 Values

Publish 请求: pending | processing | completed | partial_fAIled | fAIled | canceled

Tar获取: 队列d | scheduled | processing | sent | published | fAIled | canceled

Scheduling

设置 dis补丁At to a future UTC ISO timestamp:

{ "dis补丁At": "2026-02-20T15:00:00Z" }

设置 to null for immediate dis补丁.

Rate Limits Operation Limit 上传 20/min Read 30/min Publish 10/min 删除 20/min Error Handling

Errors return:

{ "error": "Message", "code": "ERROR_CODE" }

Common codes: MISSING_IDEMPOTENCY_KEY, IDEMPOTENCY_CONFLICT, SUBSCRIPTION_REQUIRED