Garage API

Listar veículos do jogador, catálogo, adicionar, remover e ler trunk.

Implementação no arquivo functions/garage.lua — assume snt_characters_vehicles + exports['mtg_garages'].

GET/elite-saas/garage/vehicles🔒 auth

Catálogo: todos os modelos cadastrados em mtg_garages (com nome, categoria, preço, imagem).

json

{
  "vehicles": [
    { "model": "adder", "name": "Adder", "category": "super", "price": 1000000, "image": "..." },
    { "model": "blista", "name": "Blista", "category": "compact", "price": 30000, "image": "..." }
  ]
}

GET/elite-saas/garage/<userId>🔒 auth

Garagem do jogador. Open-schema: chaves extras (ipva, status, kms…) aparecem automaticamente no painel.

json

{
  "userId": 4823,
  "vehicles": [
    {
      "plate": "ABC1D23",
      "model": "adder",
      "category": "super",
      "garage": "legion",
      "stolen": false,
      "value": 1000000,
      "ipva": "em-dia",
      "image": "https://cdn.exemplo.com/vehicles/adder.png"
    }
  ]
}

Os campos obrigatórios são plate e model. Tudo o resto é arbitrário — o painel renderiza chave/valor.

POST/elite-saas/garage/<userId>/add🔒 auth

Cria veículo no garage do usuário. Wrapper de exports['mtg_garages']:generateVehicle().

Body

model

stringrequired

Modelo cadastrado (ex.: adder).

plate

stringoptional

Plate específica. Sem ela, o adapter sorteia uma.

permanent

booleanoptional

Se false, é veículo de aluguer; passa por generateRentalVehicle().

days

integeroptional

Quando aluguer, validade em dias.

POST/elite-saas/garage/<userId>/remove🔒 auth

Apaga veículo por plate. Confirma que o owner bate.

Body

plate

stringrequired

Plate exata.

Trunk (porta-malas)

GET/elite-saas/garage/trunk/<plate>🔒 auth

Conteúdo do porta-malas. Lê de mtg_containers com key='trunk_<modelo>:<plate>'.

json

{
  "plate": "ABC1D23",
  "model": "adder",
  "items": [
    { "slot": 1, "item": "ak47", "name": "AK-47", "amount": 1, "weight": 4500, "image": "..." }
  ]
}

POST/elite-saas/garage/trunk/<plate>/remove🔒 auth

Tira item do porta-malas.

item

stringrequired

Identificador interno.

amount

integeroptional

Default 1.

slot

integeroptional

Slot específico.

Tabelas envolvidas

snt_characters_vehicles — (plate, owner, index/model, ipva, status).
mtg_containers — porta-malas armazenado como JSON com key = "trunk_<model>:<plate>".

Permissões

Visualização requer analytics.view. Add/remove veículos requerem garage.edit.

AnteriorInventory Próxima Properties