RPCrate Portal del desarrollador

RPCrate 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 RPCrate API

Un namespace, cuatro endpoints GET, solo JSON. Los nombres API publicados y visibles en el catálogo representan poblaciones de productos en lugar de tratarlos como intercambiables:

published_product_count

1.706 — Todos los productos WooCommerce publicados, incluidos los productos ocultos intencionalmente del catálogo público.

catalog_visible_product_count

1.628 — La población del catálogo público utilizada por la página de inicio y por /catalog/products.total después de los controles de visibilidad y promoción del catálogo.

GET /catalog/products páginas solo la población visible en el catálogo. Su filtrado sin total por lo tanto equivale catalog_visible_product_count; published_product_count permanece nombrado por separado en el índice API.

URL base

https://rpcrate.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://rpcrate.com/openapi.json
• https://rpcrate.com/.well-known/openapi.json — byte idéntica, para clientes que miran allí primero
• https://rpcrate.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://rpcrate.com/llms.txt describe el sitio para modelos de lenguaje.

La RPCrate 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 RPCrate.