Códigos de error

Todos los errores devuelven un JSON con la forma:

{ "error": "Descripción del error" }

Tabla de errores

Código HTTP	Causa habitual	Solución
400 Bad Request	El cuerpo de la petición está mal formado o falta un campo obligatorio (p.ej. file en POST).	Revisa los campos requeridos.
401 Unauthorized	La cabecera x-api-key falta o la clave no es válida.	Verifica que incluyes la cabecera y que la clave es correcta.
403 Forbidden	La clave es válida pero la operación está prohibida (límite de almacenamiento alcanzado, asset de otra organización, etc.).	Revisa tu plan o el ID del asset.
404 Not Found	El asset no existe o no pertenece a tu organización.	Verifica el ID del asset.
413 Payload Too Large	El archivo supera el límite de 100 MB.	Reduce el tamaño del archivo o comprimelo.
500 Internal Server Error	Error interno del servidor.	Reintenta la petición. Si persiste, contacta soporte.

Ejemplo de manejo de errores

cURL

response=$(curl -s -o /dev/null -w "%{http_code}" \
  -H "x-api-key: TU_API_KEY" \
  "https://fivehub.pro/api/assets/id_inexistente")

if [ "$response" -eq 404 ]; then
  echo "Asset no encontrado"
fi

JavaScript / TypeScript

import { FiveHubClient } from 'fivehub.pro';

const client = new FiveHubClient({ apiKey: 'TU_API_KEY' });

try {
  const asset = await client.get('id_inexistente');
} catch (err) {
  console.error(err.message); // "Asset not found"
}

FiveM (Lua)

exports.fivehub:GetAsset("id_inexistente", function(err, asset)
  if err then
    print("Error:", err) -- "Asset not found" o "HTTP 404"
    return
  end
  print(asset.name)
end)