FiveMX Portal del desarrollador

FiveMX publica un HTTP API de solo lectura sobre su catálogo de scripts FiveM, una descripción OpenAPI 3.1 del mismo y una herramienta de línea de comandos que interactúa con él. Todo en esta página es público, no necesita clave y puede ser utilizado por una persona, un script o un agente.

El catálogo FiveMX API

Un espacio de nombres, cuatro puntos finales GET, JSON solamente. Expone los mismos 1.675 productos publicados que la tienda, con precios en la moneda base de la tienda, stock, categoría y etiquetas del framework.

URL base

https://fivemx.com/wp-json/fivemx/v1

Puntos finales

• GET /catalog — índice con recuentos, moneda y enlaces a todo lo demás en esta página
• GET /catalog/categories — las 46 categorías con recuento de productos
• GET /catalog/products — una página de productos, filtrable por category y framework, hasta 50 por página
• GET /catalog/products/{slug} — un solo producto por su slug en inglés

Autenticación y escrituras

No hay ninguna, y no hay ninguna. Cada endpoint es un GET anónimo. Nada aquí crea un pedido, cambia un precio o toca una cuenta, por lo que no hay ninguna clave que filtrar y ningún estado que un error pueda dañar.

Especificación OpenAPI

La descripción completa legible por máquina, generada a partir del mismo contrato contra el que se implementa la API, por lo que las dos no pueden divergir:

• https://fivemx.com/openapi.json
• https://fivemx.com/.well-known/openapi.json — byte idéntica, para clientes que miran allí primero
• https://fivemx.com/.well-known/api-catalog — un enlace RFC 9727 que apunta a ambos

La página de inicio también lo anuncia con un rel="service-desc" enlace, y https://fivemx.com/llms.txt describe el sitio para modelos de lenguaje.

La FiveMX CLI

Una herramienta oficial de línea de comandos envuelve el mismo API. Node 18 o más reciente, cero dependencias de tiempo de ejecución.

npm install -g @fivemx/cli
fivemx catalog
fivemx products --framework qbcore --per-page 5
fivemx product audio-speaker-script --json

Los códigos de salida separan un error de uso de una interrupción sin analizar ninguna salida: 0 ok, 1 error de uso sin solicitud enviada, 2 la solicitud falló, 3 el recurso no existe.

Respuestas de error

Los errores son JSON, nunca una página HTML, y cada uno lleva un código, un mensaje y una pista que dice qué hacer a continuación.

{
  "code": "fivemx_product_not_found",
  "message": "No published product has that slug.",
  "data": {
    "status": 404,
    "hint": "Slugs come from /wp-json/fivemx/v1/catalog/products."
  }
}

Un cliente que envía Accept: application/json, o que se identifica como un agente de IA conocido, recibe esta forma para cualquier ruta faltante en el sitio, no solo dentro del espacio de nombres API. Un navegador mantiene la página de error normal.

Límites de tasa y almacenamiento en caché

No hay una cuota publicada. Las respuestas se almacenan en caché durante diez minutos en el origen, por lo que rastrear todo el catálogo es económico para ambas partes. Por favor, envía un agente de usuario que te identifique y prefiere un pase paginado a muchas solicitudes de productos individuales.

Lo que este API deliberadamente no hace

• No expone carritos, pago, pedidos, clientes ni descargas. Esas rutas están cerradas a los rastreadores en robots.txt y no se describen en la especificación.
• No sirve slugs traducidos. Las versiones localizadas del sitio usan URLs traducidas, y este API solo acepta el slug en inglés.
• No convierte precios. Los valores están en la moneda base informada por /catalog, no en la moneda seleccionada por un visitante.
• No hay servidor MCP, ni tarjeta de agente ni feed de webhook. Cuando exista uno, se listará aquí y en el catálogo API en lugar de anunciarse con un archivo vacío.

Las preguntas sobre el API pertenecen al Página de contacto FiveMX.