Descripción general

La API de NU Signal Partners permite a los socios B2B aprobados descubrir, licenciar, reproducir, medir y liquidar IP de vídeo e interactiva mediante una única integración de servidor.

Use el catálogo para revisar contenido con derechos autorizados, crear acuerdos, autorizar sesiones breves de reproducción o Runtime, enviar eventos canónicos y conciliar liquidaciones de Production.

URL base y entornos

Sandbox y Production comparten el mismo host. La clave de API determina el entorno aislado y su contexto de datos. Consulte Guía de Sandbox.

Convenciones

• Versionado — La versión de la API está fijada en la ruta (/v1).
• Autenticación — Envíe una clave Bearer en cada solicitud protegida. Consulte Autenticación. El alta pública y POST /v1/api-keys/bootstrap no usan una clave Bearer.
• JSON — Los cuerpos de solicitud y respuesta usan application/json.
• Marcas de tiempo — Use marcas de tiempo RFC 3339 / ISO 8601 UTC (por ejemplo, 2026-06-24T00:00:00Z).
• Códigos de territorio e idioma — Use códigos ISO 3166-1 alpha-2 para territorios e ISO 639-1 para idiomas.
• Importes — Los importes son números decimales acompañados de un código currency ISO 4217.

Envoltorios de respuesta

Las respuestas correctas colocan el resultado en data; los endpoints de lista también pueden incluir pagination.

{
  "data": { "...": "..." },
  "pagination": { "page": 1, "limit": 20, "total": 42, "has_next": true, "next_cursor": "eyJpZCI6..." }
}

Los errores usan un único envoltorio estable y un código legible por máquina. Consulte Códigos de error.

{
  "error": {
    "code": "validation_failed",
    "message": "La validación de la solicitud ha fallado.",
    "request_id": "req_01HQ...",
    "details": [
      {
        "field": "territories",
        "issue": "zod_invalid_format",
        "message": "El valor tiene un formato no válido."
      }
    ]
  }
}

Funciones principales

Para completar su primera integración, continúe con Inicio rápido.