投稿の操作
いずれも{"post": {…}}を返します（形式）。ただし削除は{"id": "…", "deleted": true}を返します。
| 操作 | ボディ | 実行できる人 |
|---|---|---|
POST /posts/{id}/approve |
{"publishNow"?: true, "scheduledFor"?: "…"} |
ログイン済みの人間のみ |
POST /posts/{id}/reject |
{"reason"?: "…"} |
人間、または投稿を作成したキー |
POST /posts/{id}/cancel |
なし | 人間、または投稿を作成したキー |
DELETE /posts/{id} |
なし | 人間、または投稿を作成したキー |
POST /posts/{id}/reschedule |
{"scheduledFor": "…"} |
人間、または投稿を作成したキー |
POST /posts/{id}/retry |
なし | 人間、または投稿を作成したキー |
POST /posts/{id}/first-comment/retry |
なし | キーまたは人間 |
needs_approvalの投稿を承認します。未来のscheduledForがあればその日時に予約され、なければすぐに公開されます。レスポンスはすぐにステータスpublishingで返り、Zernioへの送信はバックグラウンドで行われます。settledがtrueになるまでGET /posts/{id}をポーリングすると、scheduled、published、failedのいずれかがわかります。送信を待っている間はqueuePositionに順番が入ります。日時が過ぎている場合は、details.choices付きの409 schedule_passedが返ります。publishNow: trueか新しいscheduledForを送信してください。キーで呼び出すと403 approval_requires_humanが返ります。また、キーが自分の投稿を承認することは決してできません（self_approval_forbidden）。
承認待ちの投稿を完全に取りやめます。reasonは作成者に表示されます。キーが却下できるのは、そのキー自身が作成した投稿だけです。別のキーが作成した投稿や、アプリで作成された投稿を却下しようとすると403 reject_not_own_postが返ります。ログイン済みの人間は、承認待ちのどの投稿でも却下できます。
needs_approvalまたはscheduledの間に実行できます。2回キャンセルしても問題ありません。それ以外の状態では409 not_cancellableが返ります。キーがキャンセルできるのは、そのキー自身が作成した投稿だけです（それ以外は403 cancel_not_own_post）。取り消されたキーが作成した投稿は、ログイン済みの人間がキャンセルします。人間はどの投稿でもキャンセルできます。
一度も送信されていない投稿を完全に削除します。対象はneeds_approvalまたはrejectedの投稿と、すべてのネットワークがcancelledまたはfailedになっているcancelledまたはfailedの投稿です。最初のコメント、未送信のメール、ほかの投稿で使われていないメディアも一緒に削除されます。Zernioにコピーが残っている場合（失敗した送信）は、そのコピーも削除されます。published、partial、scheduled、publishingの投稿は409 not_deletableとなり、削除されません。予約済みの投稿は先にキャンセルしてください。キーが削除できるのは、そのキー自身が作成した投稿だけです（それ以外は403 delete_not_own_post）。ログイン済みの人間は、ワークスペース内の該当する投稿をどれでも削除できます。もう一度削除すると404 post_not_foundが返ります。
オフセット付きのISO 8601で新しい日時を指定します。承認待ちの投稿はBotdoor内で変更され、予約済みの投稿はプロバイダー側で移動されます。それ以外の状態では409 not_reschedulableが返ります。キーが日時を変更できるのは、そのキー自身が作成した投稿だけです（それ以外は403 reschedule_not_own_post）。ログイン済みの人間は、どの投稿でも日時を変更できます。
失敗した投稿の再試行
Section titled “失敗した投稿の再試行”statusがfailedの場合のみ実行できます。それ以外の場合は409 not_retryableが返ります。投稿はそのままの内容で、新しい試行として再送されます。scheduledForが過ぎている（または未指定の）場合はすぐに公開され、未来の日時なら予約が維持されます。ログイン済みの人間は、失敗したどの投稿でも再試行できます。キーが再試行できるのは、そのキー自身が作成した投稿だけです（それ以外は403 retry_not_own_post）。自動で投稿するキーの場合は、再度公開されます。承認制のキーの場合は、投稿がneeds_approvalに戻り、通常どおり承認依頼のメールが届きます。
最初のコメントの再試行
Section titled “最初のコメントの再試行”firstComment.statusがfailedの場合のみ実行できます。二重に投稿されることはありません。それ以外の場合は409 first_comment_not_failedが返ります。
| ステータス | コード |
|---|---|
| 403 | approval_requires_human、self_approval_forbidden、reject_not_own_post、retry_not_own_post、cancel_not_own_post、delete_not_own_post、reschedule_not_own_post、session_required、cross_site_request |
| 404 | post_not_found |
| 409 | not_awaiting_approval、schedule_passed、not_cancellable、not_deletable、not_reschedulable、first_comment_not_failed、not_retryable |