> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ofauth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DRM support

> Protected playback capabilities, response fields, expiry, and error handling in Access V3

Media you can view may include a `playback` descriptor. Pass it to a DRM-capable player. OFAuth handles authorization for the linked account.

Start with [Play DRM video](https://docs.ofauth.com/v3/guides/drm-playback.md), or [Retain DRM video in Vault+](https://docs.ofauth.com/v3/guides/vault-plus-drm.md).

## Supported playback

| Capability | Support |
| - | - |
| DRM system | Widevine (`com.widevine.alpha`). |
| Manifest | Static DASH (`application/dash+xml`). |
| Resource layout | Single-file representations with byte ranges, or explicit segment lists. |
| Browser | A Widevine-capable browser with the required media codecs, on HTTPS or localhost. |
| Environment | Live linked accounts. Sandbox data does not prove DRM playback, and Test does not support the live license exchange. |
| Quality | Representations permitted by the current grant and plan. |
| Storage | Encrypted Vault+ retention with a fresh license at playback. |
| Unsupported | FairPlay, PlayReady, HLS DRM, offline licenses, and decrypted downloads. |

Dynamic DASH manifests, segment templates, external resource references, and multiple alternative base URLs are rejected. A successful manifest or license response alone does not establish browser compatibility. The browser must decode frames and play audio.

## Playback descriptor

For Access responses, `playback` belongs to the media item. For Vault+ responses, it belongs to the retained variant in the item's `media` map.

```json theme={null}
{
	"playback": {
		"manifestUrl": "https://media.ofauth.com/<manifest-token>",
		"mimeType": "application/dash+xml",
		"licenseServers": {
			"com.widevine.alpha": "https://media.ofauth.com/<license-token>"
		},
		"renewUrl": "https://media.ofauth.com/<renewal-token>",
		"expiresAt": "2026-10-17T12:30:00.000Z"
	}
}
```

The URLs above illustrate the shape. Use the complete URLs returned by the API.

| Field | Contract |
| - | - |
| `manifestUrl` | `GET` loads the DASH manifest. Manifest resources already use scoped media-proxy URLs. |
| `mimeType` | `application/dash+xml`. |
| `licenseServers` | DRM key-system IDs mapped to license URLs. The Widevine URL accepts the player's binary challenge with `POST` and returns binary license bytes. |
| `renewUrl` | `GET` returns a replacement descriptor after a current access check. |
| `expiresAt` | ISO 8601 expiry for the manifest, resource, and license URLs. |
| `retainUrl` | Optional developer retention URL. `POST` requests encrypted Vault+ retention. Omitted from descriptors for already retained archives. |

`playback` is optional. It is returned for supported protected media the linked account can view. Media marked `canView: false` receives no descriptor. A missing descriptor is not permission to construct a license URL or play a protected manifest as an ordinary file.

## Authentication and delivery

Access and Vault+ API calls use the External OAuth bearer token and `x-linked-account-id`. Requests to the returned media URLs use the signed URL itself. The player does not need an API bearer token, OnlyFans cookies, signing rules, or custom origin headers.

Each request rechecks current authority. A signed URL does not preserve access after revocation. Keep these URLs out of analytics and logs, and pass them only to the authorized viewer.

The player uses the returned URLs for media and license requests. Keep the linked account connected and its access active during playback.

## Expiry and renewal

Manifest, resource, and license URLs last at most 30 minutes. Configuration can shorten this period, and live CDN credentials can expire sooner. `expiresAt` is the value your integration uses.

The renewal URL lasts 24 hours from descriptor issuance. Renewal returns a complete new descriptor, including a new renewal URL. After that URL expires, obtain the media again through Access or Vault+.

Renewal checks current access and returns fresh playback URLs. If renewal fails, fetch a new media response through Access or Vault+.

## Playback failures

Media-proxy failures can be plain text. They do not use the [Access API JSON error envelope](https://docs.ofauth.com/v3/api-reference/errors.md). Check the HTTP status before parsing a renewal response as JSON.

| Failure | Integration response |
| - | - |
| Invalid or expired URL | Renew once while `renewUrl` is valid. Otherwise, fetch a fresh Access or Vault+ media response. |
| `403` access or license denial | Stop automatic playback retries. Recheck the linked account's access through your authenticated API flow. |
| `404` retained media unavailable | Refresh the Vault+ item. A deleted archive cannot be recovered through its old URL. |
| `416` invalid range | Let the DASH player generate single byte-range requests. Do not request ranges of the manifest. |
| `502` protected playback unavailable | Check the support limits and obtain a fresh descriptor. Do not retry an unsupported manifest indefinitely. |
| `503` license or renewal service unavailable | Limit retries and wait longer after each transient failure. If renewal keeps failing, fetch a fresh Access response. |
| Encrypted media events without playback | Confirm that the player received `licenseServers`, the license request completed, and the browser supports Widevine and the media codecs. |

When you report a failure, include the failing stage, HTTP status, response text, browser, and player error code. Include the parent API request's `x-request-id`. Exclude signed URLs and binary license bodies from shared diagnostics.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.