幂等性

获取 API 密钥

网络错误可能让你无法确定帖子是否已创建。在 POST /v1/posts 和 POST /v1/media 中发送 Idempotency-Key 请求头，并用相同的键重试：Sofia 会返回与第一次相同的响应，不会重复创建任何内容。

bash

curl -X POST https://api.sofia-post.com/api/v1/posts \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d @post.json

每条新帖子使用一个新的随机键（UUID），该帖子的每次重试使用同一个键。
相同的键搭配不同的请求体会返回 422 idempotency_key_reused。
第一个请求仍在处理时，使用相同的键会返回 409 idempotency_in_progress：请稍后重试。