Interpreting responses
Learn about responses from the Apple Media Feed API to your Apple TV Feed requests.
Overview
The Apple Media Feed API has two kinds of responses to requests for Apple TV Feed data: resource collections and errors. Learn how to interpret these responses.
Understand a response
Resource collection responses contain a data array and a resources object.
Error responses contain an array of one or more error objects that indicate any issues while handling the request. The status code of the response reflects the primary error.
Default responses for common requests include the following:
Request description | Status code | Response description |
|---|---|---|
The request is for an existing single resource object. |
| The |
The request is for a single resource object that doesn’t exist. |
| The response doesn’t contain a |
The request is for multiple resource objects by ID. |
| The |
The request is for multiple resource objects by ID and none of the resources exist. |
| The |
The request isn’t accepted because its authorization is missing or invalid due to an issue with the developer token. |
| The response doesn’t contain a |
The request isn’t accepted because the request is using incorrect authentication. |
| The response doesn’t contain a |
The request isn’t supported as specified. |
| The |
The request encounters errors on the server. | Any status code in the 500 range | The |
For more information, see Error object and HTTP status codes.