Noticias de última hora
Fondo deportivo MotoRevista CR
MotoRevista CR - Pasión por los Motores
Mundo Motores CR - La Pasión por los Motores

MotoRevista CR Developer Resources

Welcome to the developer and AI agent resource center for MotoRevista CR — Costa Rica’s leading motorcycle, power sports, and automotive publication. This portal provides comprehensive technical specifications, machine-readable indexes, and programmatic access endpoints.

Markdown Content Negotiation (RFC 9110)

All public pages on MotoRevista CR, including the homepage (https://www.motorevistacr.com/), support native HTTP content negotiation. When requesting a page with Accept: text/markdown, the origin returns pure, semantic Markdown rather than HTML.

curl -sS -L -H "Accept: text/markdown" https://www.motorevistacr.com/

Negotiation Rules: Respects quality weights (q-values), wildcard specificity, and emits Vary: Accept. Clients sending non-acceptable media types receive an RFC 9457 406 Not Acceptable response.

Public REST API Endpoints

Base URL: https://www.motorevistacr.com/api/v1 (No authentication required for read-only access).

MethodEndpointDescription
GET/api/v1/motorcyclesPaginated marketplace catalog with brand, category, and price filters.
GET/api/v1/vehiclesUnified catalog covering motorcycles, ATVs, and UTVs.
GET/api/v1/vehicles/{slug}Detailed vehicle record, verified pricing, and technical specifications.
GET/api/v1/postsRecent editorial articles, launch coverage, and tech specs.
GET/api/v1/categoriesTaxonomy categories and article counts.
GET/api/v1/search?q={term}Full-text search across titles and keywords.

Typed Error Model (RFC 9457 Problem Details)

All API error responses use the media type application/problem+json. Each response contains machine-readable error codes and human-readable resolution guidance:

{
  "type": "https://www.motorevistacr.com/problems/invalid-param",
  "title": "Invalid query filter parameters.",
  "status": 400,
  "detail": "Adjust the query parameters to match the schema defined in /openapi.json.",
  "code": "INVALID_PARAM",
  "documentation_url": "https://www.motorevistacr.com/developers",
  "instance": "/api/v1/vehicles",
  "errors": {
    "page": { "_errors": ["Number must be greater than or equal to 1"] }
  }
}

Official CLI Tool

The MotoRevista CR command-line interface provides read-only inspection of articles, technical specifications, marketplace models, and OpenAPI schemas directly from the terminal.

# Run help
mrc --help
# Search catalog and articles
mrc search "yamaha" --limit 5
# Fetch vehicle details
mrc product yamaha-mt-03-2026
# Inspect OpenAPI specification
mrc openapi

Rate Limiting & Advisory Headers

Public requests are subject to an advisory rate limit of 60 requests per minute per IP. Standard IETF headers are provided on every response:

  • RateLimit-Limit: Total allowed requests per window (60)
  • RateLimit-Remaining: Remaining quota in the current window
  • RateLimit-Reset: Epoch timestamp when the quota resets
  • Retry-After: Number of seconds to wait if a 429 status code is received