API 20141201 Updates

2025-08-09: Update error code table; code 1011 is returned if the application isn't using Content-Type:application/json in the header.

2025-08-08: Be explicit that the client must send Content-Type:application/json in the header.

2025-08-08: Be explicit that the 24h token timer is based on the time of the first request.

2025-08-08: Be explicit about the responses the application might get for token requests.

2025-08-08: Be explicit that image URIs are ephemeral.

2025-08-08: Update documentation regarding program metadata; using the left-most 10 characters is deprecated.

2025-08-08: Be explicit that celebrity images and biography must use the personId element.

2025-07-13: Update error code table; add code 4010. Anti-fraud measure. Subscribers can open a ticket to increase the number of IP addresses they source from by opening a ticket with support.

2025-05-20: Add information about the image counter reset; it's at 00:00Z every day.

2025-05-19: Add details about the token response to include the serverTime field and that it can be used to determine if a client system clock is incorrect.

2025-03-15: Add note that useragent must include the version of the software for troubleshooting and to assist users in updating to the latest version of the grabber software.

2025-03-13: Add field to token request to force generation of a new token instead of returning an existing token. Add tokenExpires field to status response.

2025-03-06: Update information about issuing tokens; a token is valid for 24 hours, and any valid login during that 24 hour period will return the same token.

2025-02-13: Update error code table; add code 2055. Debugging connections must be coordinated with SchedulesDirect.

2025-02-12: Update error code table with all current error codes and human-readable explanations.

2025-02-11: Add details on code 5000 when making an image request.

2025-01-31: Add details on responses which are returned when requesting images if there are no downloads remaining for the user in this time period.

2025-01-14: Add celebrity endpoint.

2025-01-14: Provide details on the maximum number of tokens which will be issued within 24 hours.

2022-10-01: Require token in order to download image index and images.

2020-05-10: Updated stationLogo response to add categories and additional logos available.

2020-05-15: Added description for stationLogo categories.