MMEDIARAZZIVIDEO AD SERVING TECHNOLOGY
DEVELOPERS · ADVANCED

Developer API endpoint reference

Current routes, methods, permissions and known limitations.

The following endpoint list reflects the current MEDIARAZZI upgrade code, not speculative SDK capabilities.

Method Endpoint Required key
GET /commercials Read
POST /commercials Write
POST /commercials/upload Write; multipart upload
GET /commercials/{id} Read
PATCH /commercials/{id} Write
DELETE /commercials/{id} Write
GET /pods Read
POST /pods Write
PUT /pods/{id}/items Write
GET /tags Read
POST /tags Write
DELETE /tags/{id} Write
GET /statistics Read

Prefix these routes with https://mediarazzi.com/api/v1. Requests use HTTPS and bearer authentication. JSON writes use Content-Type: application/json except multipart uploads.

Useful response codes

  • 200: success
  • 201: created
  • 400 / 422: malformed or invalid request
  • 401: absent/invalid bearer token
  • 403: insufficient key permissions
  • 404: resource not found or belongs to a different account
  • 429: API rate limit exceeded
  • 500: server error; inspect server logs without exposing secrets

Current limitations

No officially released SDK, production webhooks, automatic ad mediation, server-side ad insertion, or VMAP generation is promised here. The OpenAPI JSON and implementation should be kept in sync as routes evolve.

← All documentationTroubleshooting →