Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/akibanks/api-tienda-vinilos/llms.txt

Use this file to discover all available pages before exploring further.

VinylVibes API is the backend service for an online vinyl record store. It provides endpoints for user authentication, catalog browsing via Discogs, album enrichment from Last.fm and YouTube, shopping cart checkout, and admin management — all built with Node.js, Express, Prisma, and Redis.

Quickstart

Make your first authenticated API call in minutes with a complete walkthrough.

Authentication

Register an account, obtain a JWT token, and authenticate requests.

API Reference

Full reference for all 20 endpoints — auth, catalog, user, and admin.

Core Concepts

Understand pricing logic, Redis caching, rate limits, and the system architecture.

​
What the API does

VinylVibes API integrates three external services to deliver a rich vinyl shopping experience:
  • Discogs — search the world’s largest music database for records, browse by genre, and get detailed release information including tracklists, labels, and community popularity stats.
  • Last.fm — fetch album biographies and find similar artists to power personalized recommendations.
  • YouTube — look up music videos for any album in the catalog.
Prices are calculated entirely server-side using the release year and Discogs community popularity (want/have ratio) — clients never supply or influence pricing.

​
Key capabilities

JWT Auth

Secure authentication with 7-day tokens and bcrypt password hashing.

Catalog Browsing

Search, filter by genre, and browse recent releases from Discogs.

Smart Pricing

Server-side prices based on release era and Discogs popularity.

Redis Cache

Per-endpoint caching from 1 hour to 7 days to protect API rate limits.

Checkout

Full order processing with shipping details and sale state management.

Admin Panel

Role-based access for managing users, orders, and Redis diagnostics.

​
Get started in 3 steps

1

Create an account

Register with a username and password via POST /registro. No email verification required.
2

Get your token

Log in via POST /login and receive a JWT token valid for 7 days. Include it in every protected request as Authorization: Bearer <token>.
3

Browse and buy

Search the Discogs catalog, add items to your cart, and place an order via POST /checkout. The API calculates prices server-side.
The server requires several environment variables to start — JWT_SECRET, DATABASE_URL, REDIS_URL, and API keys for Discogs, Last.fm, and YouTube. See the architecture overview for the full list.

Build docs developers (and LLMs) love

Get started for freeTalk to us