Troubleshoot Analytics Errors
Important
The Buy with Prime API is offered as a preview and might change as we receive feedback and iterate on the interfaces. We are sharing this early documentation to help you learn about the Buy with Prime API as we write and iterate on the content.
This topic describes errors that you can encounter when you call the Buy with Prime Analytics interface and suggests corrective actions that you can take.
Errors starting report tasks
The following errors can occur when you call the startReportTask mutation.
| Error Type | Error Code | Description | Suggested Action |
|---|---|---|---|
AccessDeniedError | N/A | You don't have sufficient access to perform this action. | Ensure that your access token has permission to access this information, and retry the call. For details, see Authenticate to the Buy with Prime API. |
InternalServerError | N/A | Unexpected error during request processing. | None. This is a server-side error. |
ThrottlingError | N/A | You made too many requests to the API. You can have up to five startReportTask requests in STARTED or RUNNING state at any time. | Send the request again using exponential backoff. |
ValidationError | InvalidDateFormat | Invalid date format. | Provide a valid date range. Dates must be in ISO 8601 UTC format. |
ValidationError | InvalidDateRange | Invalid date range. | Provide a valid date range. |
ValidationError | InvalidReportType | The specified report type is not one of the allowed types. | Specify a report of an allowed type. For allowed report types, see Analytics Report Types. |
Errors getting report status
The following errors can occur when you call the reportTask query.
| Error Type | Error Code | Description | Suggested Action |
|---|---|---|---|
AccessDeniedError | N/A | You don't have sufficient access to perform this action. | Ensure that your access token has permission to access this information, and retry the call. For details, see Authenticate to the Buy with Prime API. |
InternalServerError | N/A | Unexpected error during request processing. | None. This is a server-side error. |
ResourceNotFoundError | N/A | You queried an invalid or expired taskId. | Call startReportTask to create a new report. Reports expire seven days after creation. |
ThrottlingError | N/A | You made too many requests to the API. The maximum TPS is five. | Send the request again using exponential backoff. |
Errors getting a link to an analytics report
The following errors can occur when you call the reportDownloadLink query.
| Error Type | Error Code | Description | Suggested Action |
|---|---|---|---|
AccessDeniedError | N/A | You don't have sufficient access to perform this action. | Ensure that your access token has permission to access this information, and retry the call. For details, see Authenticate to the Buy with Prime API. |
InternalServerError | N/A | Unexpected error during request processing. | None. This is a server-side error. |
ResourceNotFoundError | N/A | You queried an invalid or expired taskId. | Call startReportTask to create a new report. Reports expire seven days after creation. |
ThrottlingError | N/A | You made too many requests to the API. The maximum TPS is five. | Send the request again using exponential backoff. |
Related topics
Updated 2 days ago