Overview

Base URL, request format, and the public endpoint matrix.

API Overview

Base URL

https://api.ansdev.cloud

Authentication

Pass your API key in the x-ansdev-key header on every request:

curl -H "x-ansdev-key: ak_live_YOUR_KEY" \
  https://api.ansdev.cloud/v1/video

See Authentication for scopes, key lifecycle, and limits.

Response format

Every response is JSON with a top-level success boolean.

Success:

{
  "success": true,
  "data": { /* … */ },
  "pagination": { /* (list endpoints only) */ }
}

Error:

{
  "success": false,
  "error": {
    "code":    "INVALID_API_KEY",
    "message": "The provided API key is invalid or has been revoked.",
    "status":  401
  }
}

See the full error catalog.

Endpoints

Method	Path	Auth	Description
GET	/v1/video	API key	List the caller’s videos (metadata only).
GET	/v1/video/:videoId	API key	Get a single video by vid_… or UUID.
POST	/v1/video/:videoId/playback-token	API key	Mint a 5-min playback JWT (rate-limited).
GET	/v1/video/playback/manifest/:token	playback JWT	SDK-only — exchange token for CDN URL.

The two /playback/* endpoints are documented for completeness; in practice you’ll never call them directly — the Player SDK does.

Uploads are dashboard-only. There is no POST /v1/video — files are uploaded through the Smart Stream Console at /dashboard/creative. This keeps the public surface read-only and the abuse model trivial.