> ## Documentation Index
> Fetch the complete documentation index at: https://atlas-1d44e232.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Tu primer request autenticado a la API de UGPS Atlas.

## 1. Conseguir un API token

Los integradores usan un **API token** de larga duración, con prefijo `atk_`. Crearlo
requiere una **sesión de usuario** (no un API token: administrar tus propios tokens está
reservado a la sesión, ver [Autenticación](/autenticacion)), así que se emite desde la
plataforma, iniciando sesión con un usuario que tenga el permiso `access_api_keys`. Si no
tenés ese acceso, pedile el token al administrador de tu cuenta.

<Warning>
  El token se muestra una sola vez, al crearlo. Guardalo en tu gestor de secretos: no se
  puede recuperar después.
</Warning>

## 2. Llamar a la API

```bash theme={null}
curl https://api.ugps.io/api/assets \
  -H "Authorization: Bearer atk_tu_token_acá"
```

Respuesta (recortada):

```json theme={null}
{
  "status": "success",
  "data": [
    {
      "_id": "665f1c2e8b1a4c0012a3b4c5",
      "name": "Camión 12",
      "plate": "ABCD12"
    }
  ]
}
```

## 3. Verificar que la API está viva

`GET /health` no necesita credenciales y es útil para monitoreo:

```bash theme={null}
curl https://api.ugps.io/health
```

## Siguiente paso

Los detalles de los dos esquemas de credenciales están en
[Autenticación](/autenticacion). Cuando un request falle, el
[catálogo de códigos de error](/errores) explica qué significa cada `code`.