History: Errors

Every change to this page, newest first. Expand an entry to see what changed.

← Errors

1. 1 Oct 2026 · +2 −1 lines
   Show changes

   ⋯
     | 400 | `invalid_device_info` | A device value looks empty or invalid, for example the string `"(null)"`. `fields` names the bad values. | Fix how your app reads the values from the Player SDK. |
     | 401 | none | Missing, invalid or revoked API key. | Check the key. Do not retry. |
   - | 403 | none | The key lacks the `playback` scope. | Use the playback key Wandura issued to you. |
   + | 403 | none | The key lacks the `playback` scope. | Use a playback key: create one on **Developers** → **Stream films in an app**. |
     | 403 | `not_entitled` | Your organisation is not licensed to stream this film right now. `reason` gives the detail. | Show your locked or unavailable state. Do not retry. |
     | 404 | `not_ready` | The episode or film is unknown, not published, or not ready to stream. | Show "not available yet". Refresh your catalog. |
   ⋯
     | 503 | `not_ready` | No playable version of this episode is available right now. | Show "not available yet". Retry later. |
     | 503 | `service_unavailable` | Wandura could not check the API key in time. The key is **not** wrong. | Retry after `Retry-After` seconds, with backoff. Do not rotate the key. |
   + | 503 | `service_unavailable` | The video provider did not answer in time (playback only). Nothing is wrong with the episode or your key. | Retry after `Retry-After` seconds (2), with backoff. |
     
     ### `not_entitled` reasons
   ⋯

2. 1 Oct 2026 · +1 −1 lines
   Show changes

   ⋯
     | Field | Type | Description |
     |---|---|---|
   - | `error` | string | Human-readable message. Log it, but do not parse it. |
   + | `error` | string | Human-readable message. Log it, but do not parse it, except for the catalog `403` below. |
     | `error_code` | string | Machine-readable code. Branch on this. Absent on some errors, listed below as "none". |
     | `reason` | string | Only with `not_entitled`: the detailed reason, for logs and support. |
   ⋯

3. 1 Oct 2026 · +2 −2 lines
   Show changes

   ⋯
     | 401 | none | `Invalid or revoked API key` | The key is unknown or revoked. | Check the key. Do not retry. |
     | 403 | none | `This API key does not have the metadata:read scope` | The key lacks the scope. | Use a key with `metadata:read`. |
   - | 403 | none | `org_suspended` | Your organisation's access is suspended. | Contact your Wandura partner contact. Do not retry. |
   + | 403 | none | `org_suspended` | Your organisation's access is suspended. | Contact Wandura. Do not retry. |
     | 429 | `rate_limited` | | Rate limit reached. | Wait for `Retry-After`. |
     | 503 | `service_unavailable` | `Could not verify the API key right now — retry` | Wandura could not check the key in time. The key is **not** wrong. | Retry after `Retry-After` seconds, with backoff. Do not rotate the key. |
   ⋯
     | 401 | 4011 | `Invalid or revoked API key` | The key is unknown or revoked. | Check the key. Do not retry. |
     | 403 | 4030 | `This API key does not have the creatives:export scope` | The key lacks the scope. | Use a key with `creatives:export`. |
   - | 403 | 4031 | `org_suspended` | Your organisation's access is suspended. | Contact your Wandura partner contact. |
   + | 403 | 4031 | `org_suspended` | Your organisation's access is suspended. | Contact Wandura. |
     | 404 | 4040 | `Creative not found` | `GET /creatives/{id}` only. The creative does not exist, belongs to another organisation or is not approved. | Remove it from your active set. |
     | 422 | 4220 | `limit must be an integer between 1 and 100` | List only. Bad `limit`. | Fix the request. |
   ⋯

4. 30 Sept 2026 · +3 −0 lines
   Show changes

   ⋯
     | 403 | none | `org_suspended` | Your organisation's access is suspended. | Contact your Wandura partner contact. Do not retry. |
     | 429 | `rate_limited` | | Rate limit reached. | Wait for `Retry-After`. |
   + | 503 | `service_unavailable` | `Could not verify the API key right now — retry` | Wandura could not check the key in time. The key is **not** wrong. | Retry after `Retry-After` seconds, with backoff. Do not rotate the key. |
     
     ## Playback errors
   ⋯
     | 502 | none | Wandura could not prepare the stream or sign the play token. | Retry with backoff. |
     | 503 | `not_ready` | No playable version of this episode is available right now. | Show "not available yet". Retry later. |
   + | 503 | `service_unavailable` | Wandura could not check the API key in time. The key is **not** wrong. | Retry after `Retry-After` seconds, with backoff. Do not rotate the key. |
     
     ### `not_entitled` reasons
   ⋯
     | 429 | none (flat body, `error_code` `rate_limited`) | | Rate limit reached. | Wait for `Retry-After`. |
     | 503 | 5030 | `The creative feed is temporarily unavailable` | Temporary problem on Wandura's side. | Retry with backoff. |
   + | 503 | 5031 | `Could not verify the API key right now — retry` | Wandura could not check the key in time. The key is **not** wrong. | Retry with backoff. Do not rotate the key. |
     
     ## Retry guidance
   ⋯

5. 29 Sept 2026 · Page created