Ejemplos con cURL¶

Ejemplos de línea de comandos usando cURL para la API de SubX.

Configuración¶

# Configura tu clave de API como variable de entorno
export SUBX_API_KEY="{TU_CLAVE_API}"

Ejemplos Básicos¶

Health Check¶

curl https://subx-api.duckdns.org/api/health

Búsqueda por Título¶

curl -X GET "https://subx-api.duckdns.org/api/subtitles/search?title=Dexter&limit=10" \
  -H "Authorization: Bearer $SUBX_API_KEY"

Búsqueda por ID de IMDb¶

curl -X GET "https://subx-api.duckdns.org/api/subtitles/search?imdb_id=tt0773262&limit=20" \
  -H "Authorization: Bearer $SUBX_API_KEY"

Obtener Detalles del Subtítulo¶

curl -X GET "https://subx-api.duckdns.org/api/subtitles/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer $SUBX_API_KEY"

Descargar Subtítulo¶

curl -X GET "https://subx-api.duckdns.org/api/subtitles/550e8400-e29b-41d4-a716-446655440000/download" \
  -H "Authorization: Bearer $SUBX_API_KEY" \
  -o subtitulo.srt

Ejemplos Avanzados¶

Formatear JSON con jq¶

curl -X GET "https://subx-api.duckdns.org/api/subtitles/search?title=Dexter&limit=5" \
  -H "Authorization: Bearer $SUBX_API_KEY" | jq '.'

Extraer solo los títulos¶

curl -s -X GET "https://subx-api.duckdns.org/api/subtitles/search?title=Dexter&limit=10" \
  -H "Authorization: Bearer $SUBX_API_KEY" | jq -r '.items[].title'

Buscar y descargar primer resultado¶

#!/bin/bash
RESULT=$(curl -s -X GET "https://subx-api.duckdns.org/api/subtitles/search?title=Dexter&limit=1" \
  -H "Authorization: Bearer $SUBX_API_KEY")

SUBTITLE_ID=$(echo $RESULT | jq -r '.items[0].id')

if [ "$SUBTITLE_ID" != "null" ]; then
  curl -X GET "https://subx-api.duckdns.org/api/subtitles/$SUBTITLE_ID/download" \
    -H "Authorization: Bearer $SUBX_API_KEY" \
    -o "dexter.srt"
  echo "Descargado: dexter.srt"
else
  echo "No se encontraron subtítulos"
fi

Ver la Guía de Inicio Rápido para más ejemplos.