Claves API

Crea nuevas claves API de servidor a servidor usando una clave API Access existente. Esto te permite aprovisionar claves Client-Side Player y Client-Side Upload bajo demanda — por ejemplo, generar una clave de player con alcance por cliente.

Las claves URL Signing solo están en el panel

Las claves URL Signing (ver Signing Keys) no se pueden crear ni gestionar a través de la API. Deben crearse desde Settings → API Keys en el panel de AudioDN. Las claves Inline Share sí se pueden crear vía POST /v1/api_key con api_key_type_id: “share”.

Las claves API Access se crean en el panel

Primero debes crear una clave API Access desde Settings → API Keys en el panel de AudioDN. Esa clave autentica este endpoint. Las propias claves API Access no se pueden crear vía la API.

Tipos de clave creables

player — Clave Client-Side Player para reproducción
uploader — Clave Client-Side Upload para subidas
share — Clave Inline Share para redirecciones públicas GET /v1/stream/{track_id}/{share_key} (exactamente una variante; expires_at se ignora)

Los tipos api (API Access) y URL Signing no se pueden crear aquí — se gestionan solo desde la página Settings → API Keys del panel.

Caducidad y alcance

Vía la API, expires_at es opcional para ambos tipos de clave — omítelo para crear una clave que no caduque por tiempo. Opcionalmente puedes limitar una clave a un collection_id concreto (y además a un track_id). Si tu clave API Access ya tiene alcance a una colección, la nueva clave no puede tener un alcance fuera de ella.

Descargas: una clave de player puede permitir descargas opcionalmente. Esto se configura desde el panel al crear la clave (el interruptor Allow downloads) y no es configurable a través de este endpoint de la API. El permiso de descarga de la clave es autoritativo: el atributo downloadable del player solo solicita descargas, y una sesión de reproducción es descargable solo cuando la clave lo permite y la solicitud lo activa.

POST /v1/api_key

Crea una nueva clave API de player o uploader

Parámetros

Nombre	Tipo	Obligatorio	Descripción
`title`	string	Obligatorio	Nombre de la clave API
`api_key_type_id`	string	Obligatorio	Uno de 'player', 'uploader' o 'share'.
`collection_id`	uuid	Opcional	Limitar la clave a una colección concreta
`track_id`	uuid	Opcional	Limitar la clave a una pista concreta (requiere collection_id)
`creator_id`	uuid	Opcional	Limitar la clave a un creator concreto
`variants`	array of strings	Opcional	Opcional. Limitar una clave de player a variantes concretas.
`expires_at`	string	Opcional	Fecha/hora de caducidad ISO 8601. Opcional; omítelo para una clave que no caduque por tiempo.

Ejemplo de solicitud

curl -X POST "https://api.audiodelivery.net/v1/api_key" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Customer Player Key",
  "api_key_type_id": "player",
  "collection_id": "COLLECTION_ID"
}'

const payload = {
  "title": "Customer Player Key",
  "api_key_type_id": "player",
  "collection_id": "COLLECTION_ID"
};

const response = await fetch('https://api.audiodelivery.net/v1/api_key', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload)
});

const data = await response.json();

import Foundation

func performRequest() async throws {
    var request = URLRequest(url: URL(string: "https://api.audiodelivery.net/v1/api_key")!)
    request.httpMethod = "POST"
    request.setValue("Bearer YOUR_API_KEY", forHTTPHeaderField: "Authorization")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    let bodyJSON = """
{
  "title": "Customer Player Key",
  "api_key_type_id": "player",
  "collection_id": "COLLECTION_ID"
}
"""
    request.httpBody = bodyJSON.data(using: .utf8)
    let (data, _) = try await URLSession.shared.data(for: request)
    let json = try JSONSerialization.jsonObject(with: data) as! [String: Any]
    // use json
}

import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import okhttp3.*
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody

val client = OkHttpClient()

suspend fun performRequest(): String = withContext(Dispatchers.IO) {
    val body = """{
  "title": "Customer Player Key",
  "api_key_type_id": "player",
  "collection_id": "COLLECTION_ID"
}""".toRequestBody("application/json".toMediaType())
    val request = Request.Builder()
        .url("https://api.audiodelivery.net/v1/api_key")
        .post(body)
        .addHeader("Authorization", "Bearer YOUR_API_KEY")
        .addHeader("Content-Type", "application/json")
        .build()
    val response = client.newCall(request).execute()
    response.body?.string() ?: error("Empty response body")
}

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<Map<String, dynamic>> performRequest() async {
  final response = await http.post(
    Uri.parse("https://api.audiodelivery.net/v1/api_key"),
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: jsonEncode({
  "title": "Customer Player Key",
  "api_key_type_id": "player",
  "collection_id": "COLLECTION_ID"
}),
  );
  if (response.statusCode < 200 || response.statusCode >= 300) {
    throw Exception('Request failed: ${response.statusCode}');
  }
  return jsonDecode(response.body) as Map<String, dynamic>;
}

Respuesta

{
"ok": true,
"api_request_id": "uuid",
"api_key": "string"
}

Se muestra una sola vez

La api_key completa se devuelve solo en esta respuesta y nunca se almacena en texto plano. Guárdala de forma segura — no se puede recuperar de nuevo.