Bitbucket
API REST 2.0 de Bitbucket Cloud para repositorios, PRs, commits, webhooks y workspaces.
Ver la documentaciónPara qué sirve
Qué problema resuelve
Bitbucket Cloud API 2.0 gestiona repositorios, pull requests, commits y workspaces. El límite publicado es de 60 solicitudes por hora sin autenticación y 1.000 por hora con autenticación para endpoints de repositorio.
En la práctica
Qué puedes hacer con ella
- Listar repos de un workspace.
- Leer pull requests.
- Gestionar webhooks.
- Automatizar con App password.
- Paginar colecciones REST.
¿Es gratis?
Capa gratuita documentada
Bitbucket Cloud ofrece plan gratuito; la API aplica una ventana de una hora: 60 solicitudes sin autenticación y 1.000 con autenticación para datos de repositorio. Los límites escalados pueden llegar a 10.000 en planes Standard y Premium.
Comprobado el 2026-08-02. Fuente: página oficial de precios o límites
Qué cuenta como una «llamada» o unidad aquí
Cada llamada a api.bitbucket.org/2.0 cuenta 1 en la ventana horaria. Autenticarte sube el techo frente al anónimo.
Rate limits Bitbucket Cloud
| Límite | Cuota | Qué significa en la práctica |
|---|---|---|
| Anónimo | 60 / hora | Ventana rodante. |
| Autenticado (repos) | 1.000 / hora | Límite predeterminado; hasta 10.000 con límites escalados. |
| 429 | Esperar | Respeta Retry/headers. |
Planes / coste
| Plan | Precio | Para quién | Qué incluye (resumen) |
|---|---|---|---|
| Free producto | $0 | Equipos pequeños. | API usable con rate limits. |
| Standard/Premium | Ver Atlassian | Más límites/features. | Scaled API limits. |
Uso permitido, comercial y licencia
| Pregunta | Respuesta clara |
|---|---|
| ¿SaaS? | Sí: Atlassian Bitbucket. |
| ¿Comercial? | Según plan Cloud y ToS. |
| ¿Cuenta? | Sí para casi todo útil (token/App password). |
Cómo empezar
Listar los repositorios de un workspace autenticado.
Sigue los pasos con la documentación oficial y tus credenciales.
Dirección base de las imágenes: https://api.bitbucket.org/2.0
- 01
Paso 1
Crea un App password o Access Token en Bitbucket Cloud con scopes de repositorio.
- 02
Paso 2
Consulta la intro REST en developer.atlassian.com/cloud/bitbucket/rest/intro/.
- 03
Paso 3
Haz GET https://api.bitbucket.org/2.0/repositories/{workspace} con autenticación Basic u OAuth.
- 04
Paso 4
Pagina con los enlaces next del JSON y respeta el límite horario si recibes 429.
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 Bitbucket Cloud API 2.0. Docs: https://developer.atlassian.com/cloud/bitbucket/rest/intro/ . Límites: https://support.atlassian.com/bitbucket-cloud/docs/api-request-limits/ . Aplica 60 solicitudes/hora sin autenticación y 1.000/hora con autenticación en repositorios; lee las cabeceras de rate limit. No inventes credenciales. ¿Qué operación implementamos primero?Detalle técnico
Acceso, HTTPS y CORS
- 01
Acceso · OAuth
Requiere flujo OAuth: el usuario autoriza tu aplicación antes de leer sus datos.
- 02
HTTPS · Sí
Sirve sobre TLS, así que vale para producción y para páginas ya en HTTPS.
- 03
CORS · Sin verificar
No consta si permite llamadas desde el navegador; pruébalo antes de montar el cliente.