Skip to main content
AmzDownloader returns an HTTP error for requests it cannot fulfill and a job status for asynchronous extraction. Check both the HTTP status and the returned job status before continuing. Preserve the returned error code and request ID for troubleshooting. Do not log API keys or full authentication headers.

​
Watch terminal job states

A 202 response means you must inspect the body. queued and processing can be polled again after a delay. completed means you can fetch the result. failed and expired are terminal; stop polling and inspect the error. Reaching your own polling deadline does not mean that the job failed or was canceled. Save the job ID and check it later instead of automatically creating another extraction.

​
Retry charged operations deliberately

Use the same Idempotency-Key for a retry of the same method, path and input. Use a different key only for new work. Do not automatically retry a write without its original key after a connection interruption. When a source blocks extraction, a response may include a fallback result or guidance. Preserve source warnings and freshness information. A failed request consumes no credits. See cache and freshness for handling stale results.