你能發布的一切，你的程式碼也能發布。
API 執行的規則和驗證與 App 完全相同：在一邊通過的貼文，在另一邊也會通過。
- 有權限範圍的金鑰
每把金鑰都為一個工作空間和一組權限建立。唯讀金鑰無法發布，每次呼叫都有頻率限制並會被記錄。
- OpenAPI 文件
貼文、媒體上傳、佇列、社群帳號、數據分析和 AI：撰寫文案、產生圖片、建議和設定替代文字。整個介面都以規格描述，你可以據此產生用戶端。
- 經過簽署的 Webhook
十三種事件，從 post.published 到 connection.revoked。每次傳送都經過簽署，失敗時會重試，也能從 App 重新傳送。
- 給代理程式的 MCP
只要一個網址，就能連結你的 AI 代理程式。代理程式會依名稱找到貼文和媒體、起草、排程和讀取成效，而任何公開或需要花費的動作，SPREVA 都會先詢問。代理程式永遠看不到平台的權杖。
- 每分鐘 120 次
- 以工作空間中的每個人計算，錯誤訊息中會附上需要等待的時間。
- 10 秒
- Webhook 須在這段時間內回應，否則會重試。
curl -X POST https://dev-app.spreva.ai/api/v1/posts \
-H "Authorization: Bearer spreva_sk_..." \
-H "Content-Type: application/json" \
-d '{
"content": {
"caption": "Ship day. New build is live.",
"mediaIds": ["c47e2a90-0000-4000-8000-000000000004"]
},
"targets": [
{ "connectionId": "e81b3f52-...-005", "placement": "feed" },
{ "connectionId": "a31d9f07-...-006", "placement": "reel",
"override": { "caption": "Ship day. Full notes in bio." } }
]
}'curl -X POST https://dev-app.spreva.ai/api/v1/posts/$POST_ID/schedule \
-H "Authorization: Bearer spreva_sk_..." \
-d '{ "scheduledAt": "2026-10-01T09:00:00.000Z",
"timezone": "Europe/Lisbon" }'POST /hooks/spreva HTTP/1.1
x-spreva-event: target.published
x-spreva-event-id: 7f3c2d10-0000-4000-8000-000000000000
x-spreva-timestamp: 1790845202
x-spreva-signature: v1=6f1c… # HMAC-SHA256 of "timestamp.body"
{
"id": "7f3c2d10-0000-4000-8000-000000000000",
"type": "target.published",
"createdAt": "2026-10-01T09:00:02.412Z",
"workspaceId": "0b9f6c1e-0000-4000-8000-000000000001",
"data": {
"type": "TargetPublished",
"workspaceId": "0b9f6c1e-0000-4000-8000-000000000001",
"postId": "5d2a7c3e-0000-4000-8000-000000000002",
"targetId": "9a1f4b7d-0000-4000-8000-000000000003",
"provider": "instagram",
"remoteId": "17900000000000000",
"remoteUrl": "https://www.instagram.com/p/EXAMPLE/"
}
}