Documentación para Desarrolladores
La API de MotoRevista CR ofrece acceso de solo lectura al catálogo completo de artículos, fichas técnicas y categorías. No requiere registro ni API key.
Sin Autenticación
Todos los endpoints son públicos. No necesitas API key ni token.
Rate Limit
60 solicitudes por minuto por IP. Ver cabeceras RateLimit-*.
Base URL
https://www.motorevistacr.comEndpoints
/api/postsLista de artículos recientesDevuelve una lista paginada de artículos. Filtrable por categoría o tag.
Parámetros
| Nombre | Tipo | Default | Descripción |
|---|---|---|---|
limit | integer | 10 | Máx. resultados (1–50) |
page | integer | 1 | Número de página (base 1) |
category | string | — | Slug de categoría (ej: motos-nuevas) |
tag | string | — | Slug de tag (ej: honda) |
Ejemplo
curl "https://www.motorevistacr.com/api/posts?limit=5&category=motos-nuevas"
/api/posts/{slug}Artículo por slugDevuelve el artículo completo: contenido HTML, autor, imagen destacada, metadatos SEO y datos de ficha técnica (si aplica).
Ejemplo
curl "https://www.motorevistacr.com/api/posts/honda-cb300r-ficha-tecnica"
/api/categoriesTaxonomía de categoríasDevuelve todas las categorías disponibles. Usa el campo slug en /api/posts?category={slug} para filtrar.
Ejemplo
curl "https://www.motorevistacr.com/api/categories"
/api/searchBúsqueda de texto completoBusca en títulos y palabras clave de todos los artículos.
| Parámetro | Requerido | Descripción |
|---|---|---|
q | Sí | Término de búsqueda (2–200 chars) |
limit | No | Máx. resultados (1–50, default 10) |
Ejemplo
curl "https://www.motorevistacr.com/api/search?q=yamaha+mt07&limit=5"
Formato de Errores
Todos los errores devuelven JSON con la siguiente estructura:
{
"error": {
"code": "POST_NOT_FOUND",
"message": "No post found with slug 'mi-slug'.",
"hint": "Use GET /api/posts to list available posts and their slugs.",
"documentation": "https://www.motorevistacr.com/developers"
}
}Rate Limiting
El límite es de 60 solicitudes por minuto por IP. Cada respuesta incluye estas cabeceras:
| Cabecera | Descripción |
|---|---|
| RateLimit-Limit | Límite máximo por ventana (60) |
| RateLimit-Remaining | Solicitudes restantes en la ventana actual |
| RateLimit-Reset | Unix timestamp de reinicio de la ventana |
| Retry-After | Segundos a esperar (solo en respuestas 429) |