API Documentation

Documentación de referencia para la API REST de Virtual Binders. Accede a los endpoints públicos de tiendas y carpetas.

Información General

La API de Virtual Binders está construida con FastAPI y sigue los estándares REST. Todas las respuestas están en formato JSON.

Base URL: https://api.virtualbinders.com/api/v1

Documentación interactiva: Puedes explorar todos los endpoints disponibles en /docs (Swagger UI) o /redoc (ReDoc).

GET /stores — Listar tiendas
GET /stores/:slug — Detalle de tienda
GET /stores/:slug/binders — Carpetas de una tienda

GET /binders/:id/page/:num — Página de carpeta
GET /slots/:id — Detalle de un slot

POST /auth/login — Iniciar sesión
POST /auth/register — Crear cuenta
GET /auth/me — Usuario actual

GET /scryfall/search — Buscar cartas
Integración con la API de Scryfall para obtener datos e imágenes de cartas MTG.

Los endpoints protegidos requieren un token JWT en el header de la petición:

Authorization: Bearer <tu_token_jwt>

El token se obtiene al hacer login exitoso en POST /auth/login. Los endpoints públicos (listado de tiendas, carpetas) no requieren autenticación.

Para mantener la estabilidad del servicio, aplicamos los siguientes límites:

Si necesitas límites más amplios para integraciones especiales, contáctanos.

Nuestro equipo técnico puede asistirte con integraciones.