/ API documentation Documentación de API Legacy v1Heredada v1 Platform v2Plataforma v2

FuelCheck · Sherut GPS

FuelCheck · Sherut GPS

Two APIs, one reference

Dos APIs, una sola referencia

The legacy Java tracking service and the Laravel platform run side by side. They share a database and nothing else — neither one calls the other. The legacy contract is frozen; the platform is where everything new is built.

El servicio de rastreo heredado en Java y la plataforma en Laravel funcionan en paralelo. Comparten la base de datos y nada más: ninguno llama al otro. El contrato de la API heredada está congelado; la plataforma es donde se construye todo lo nuevo.

Frozen contract Contrato congelado

GPS / IoT API v1

API de GPS / IoT v1

Fleet integration, the garage front-end and the Moto app. Written by hand and complete — including the response quirks that existing clients depend on.

Integración de flotas, el front-end del taller y la app Moto. Redactada a mano y completa, incluyendo las peculiaridades de respuesta de las que dependen los clientes actuales.

Endpoints
Endpoints
30
Schemas
Esquemas
CompleteCompletos
Status
Estado
Regression-testedCon pruebas de regresión
Current Vigente

Platform API v2

API de la plataforma v2

The Laravel surface. Generated from the live route table, so every path, verb and authorisation rule is current the day it is built.

La superficie de Laravel. Se genera a partir de la tabla de rutas en vivo, así que cada ruta, verbo y regla de autorización está al día el mismo día en que se construye.

Endpoints
Endpoints
597
Schemas
Esquemas
Not describedSin describir
Status
Estado
InventoryInventario

Why the two read so differently.

Por qué las dos se leen tan distinto.

The legacy spec is hand-written because it is a freeze: its job is to record the surprising details, not tidy them away. The platform spec is generated because the application has no annotations or API Resources to describe payloads from, and inventing schemas would produce a document that looks authoritative and is not. For a platform endpoint's payload, read the controller named in the operation.

La especificación heredada está escrita a mano porque es un congelamiento: su trabajo es dejar constancia de los detalles sorprendentes, no ocultarlos. La especificación de la plataforma se genera porque la aplicación no tiene anotaciones ni API Resources de dónde describir los cuerpos de las peticiones, e inventar esquemas produciría un documento que parece autoritativo sin serlo. Para el cuerpo de un endpoint de la plataforma, consulte el controlador que se nombra en la operación.