Docker Hub
API de Docker Hub para repositorios, tags, organizaciones y autenticación de registro.
Ver la documentaciónPara qué sirve
Qué problema resuelve
Docker Hub API gestiona repos, tags y auth del registro.
Pulls anónimos 100/6h; Personal autenticado 200/6h; planes superiores sin el mismo techo de pull rate.
En la práctica
Qué puedes hacer con ella
- Listar tags de una imagen.
- Autenticarte al registry.
- Gestionar repos de tu org.
- Respetar pull rate limits.
- Automatizar CI con token.
¿Es gratis?
Capa gratuita documentada
Cuenta Personal gratuita con acceso a Hub. Pulls: 100/6 h sin autenticar (por IP) y 200/6 h autenticado en Personal; planes Pro/Team/Business sin límite de pull rate (fair use). Además hay un abuse rate limit por IP sobre Hub/API.
Comprobado el 2026-08-02. Fuente: página oficial de precios o límites
Qué cuenta como una «llamada» o unidad aquí
Los pulls de imágenes cuentan para el rate limit de 6 horas. Las llamadas a la Hub API tienen además abuse limits por IP.
Pull rate / Hub
| Límite | Cuota | Qué significa en la práctica |
|---|---|---|
| Pull anónimo | 100 / 6 h por IP | Pulls sin autenticar. |
| Pull Personal auth | 200 / 6 h | Cuenta free. |
| Pro/Team/Business | Sin límite de pull rate (fair use) | Planes de pago. |
Planes / coste
| Plan | Precio | Para quién | Qué incluye (resumen) |
|---|---|---|---|
| Personal | $0 | Individuos. | 200 pulls/6h auth. |
| Pro/Team/… | Ver docker.com/pricing | Equipos. | Más pulls/features. |
Uso permitido, comercial y licencia
| Pregunta | Respuesta clara |
|---|---|
| ¿SaaS? | Sí: Docker Hub comercial. |
| ¿Comercial? | Según plan Docker. |
| ¿Cuenta? | Recomendada/autenticada para más pulls. |
Cómo empezar
Listar tags de un repositorio público con la Hub API.
Sigue los pasos con la documentación oficial y tus credenciales.
Dirección base de las imágenes: https://hub.docker.com/v2
- 01
Paso 1
Abre la referencia OpenAPI de Docker Hub API y localiza el endpoint de tags del repositorio.
- 02
Paso 2
Crea un personal access token en Docker Hub (Account Settings → Personal access tokens).
- 03
Paso 3
Obtén un JWT con POST a https://hub.docker.com/v2/users/login/ (usuario + token) o usa el flujo documentado.
- 04
Paso 4
Haz GET https://hub.docker.com/v2/repositories/library/nginx/tags/ con Authorization: Bearer <jwt>.
- 05
Paso 5
Si automatizas pulls de imágenes, autentica el cliente: Personal tiene 200 pulls/6 h; mira las cabeceras ratelimit-*.
Con tu agente
Prompt para integrar la API
Prompt para que tu agente lo deje listo
Pega esto en Cursor, Claude Code, Codex u otro agente de código:
Integra docker-hub. Docs: https://docs.docker.com/reference/api/hub/latest/ Pricing: https://www.docker.com/pricing/. Free/cuota: 100 pulls/6 h anónimo; 200 pulls/6 h Personal autenticado. No inventes secretos ni cifras fuera de la fuente. ¿Qué operación implementamos primero?Detalle técnico
Acceso, HTTPS y CORS
- 01
Acceso · Clave gratuita
Pide una clave que se obtiene con un alta gratuita en el propio servicio.
- 02
HTTPS · Sí
Sirve sobre TLS, así que vale para producción y para páginas ya en HTTPS.
- 03
CORS · Sí
Permite llamarla directamente desde el navegador sin proxy intermedio.