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.

GET /redis-ping is an administrative diagnostic endpoint that verifies the Redis connection and lists all keys currently stored in the cache. It uses SCAN (non-blocking) instead of KEYS to safely inspect the keyspace in production, iterating through the store in batches without stalling other requests.

​
Endpoint details

PropertyValue
MethodGET
Path/redis-ping
AuthJWT — admin or demo role

​
Request parameters

No query parameters or request body required.

​
Response

​
estado
string
Connection health indicator. "conectado" if Redis responds to PING with PONG; "error" otherwise.
​
keys_en_cache
integer
Total number of keys currently present in Redis across all namespaces.
​
keys
array of strings
Alphabetically sorted list of every key found during the SCAN traversal.

​
Example response

{
  "estado": "conectado",
  "keys_en_cache": 7,
  "keys": [
    "buscar:pink floyd:1",
    "buscar:radiohead:1",
    "disco:1234567",
    "disco:7654321",
    "genero:rock:1",
    "recomendaciones:1234567:anonimo",
    "recientes"
  ]
}

​
Example request

curl -X GET https://api.vinylvibes.example/redis-ping \
  -H "Authorization: Bearer <admin_token>"

​
Cache key patterns

VinylVibes uses a consistent naming scheme for Redis keys so each resource namespace is easy to identify at a glance:
PatternSource endpointTTL
buscar:<query>:<page>GET /buscar1 hour
genero:<genre>:<page>GET /genero/:genero24 hours
recientesGET /recientes24 hours
disco:<discogs_id>GET /disco/:id7 days
historia:<discogs_id>GET /disco/:id/historia7 days
video:<discogs_id>GET /disco/:id/video7 days
recomendaciones:<id>:<user_or_anonimo>GET /disco/:id/recomendaciones1 hour
For full TTL values and cache invalidation behaviour, see Caching.

​
Error response

If Redis is unreachable or throws during the SCAN loop, the endpoint returns HTTP 500: 
{
  "estado": "error",
  "mensaje": "connect ECONNREFUSED 127.0.0.1:6379"
}
FieldTypeDescription
estadostringAlways "error" on failure.
mensajestringThe underlying error message from the exception.
The endpoint uses Redis SCAN in batches of 100 keys (COUNT 100) rather than the blocking KEYS * command, making it safe to call against production instances with large keystores without risking server latency spikes.

Build docs developers (and LLMs) love

Get started for freeTalk to us