REST API
Error
Format error dan arti kode yang paling sering muncul.
{
"error": {
"code": "caption_too_long",
"message": "Threads allows at most 500 characters",
"details": { "platform": "threads", "account_id": "b2.." }
}
}code stabil dan aman dipakai di kode kamu. message bisa berubah.
| HTTP | Kode |
|---|---|
| 400 | validation_failed, caption_too_long, media_required, media_invalid_format, too_many_media, invalid_options, option_requires_text_only, too_many_links |
| 401 | unauthenticated, invalid_api_key, invalid_token |
| 403 | insufficient_scope (key hanya punya akses baca), email_not_verified |
| 404 | not_found |
| 409 | idempotency_conflict, post_not_editable, post_not_removable, media_in_use |
| 422 | account_expired (hubungkan ulang akun), publishing_limit_reached, permission_missing |
| 429 | rate_limited |
| 502 | platform_error (error dari Meta yang tidak dikenali) |
Kenapa post gagal
Setiap target post punya error_code bila gagal terbit, misalnya account_expired, permission_missing, rate_limited, media_fetch_failed, image_too_large, aspect_ratio_invalid, caption_too_long, atau publish_limit_reached. error_message berisi pesan asli dari Meta.
Error sementara dari Meta diulang otomatis. Untuk yang lain, perbaiki penyebabnya lalu panggil POST /v1/posts/{id}/retry.