---
title: Inicio rapido
category:
  uri: guides
content:
  excerpt: Autentica tu primera solicitud y consulta el contexto financiero efectivo.
---

# Inicio rapido

La API financiera de Kanan permite consultar y operar los espacios financieros autorizados mediante HTTPS y JSON.

**URL base**

```text
https://api.kanan.app/v1/financial
```

## Antes de comenzar

Necesitas una API key creada en [Configuracion de Kanan](https://kanan.app/settings). Guarda el secreto `kni_live_*` en un gestor de secretos: Kanan solo lo muestra una vez.

## Primera solicitud

```curl
curl "https://api.kanan.app/v1/financial/context" \
  --header "Authorization: Bearer <KNI_LIVE_SECRET>" \
  --header "Accept: application/json"
```

Una respuesta exitosa usa este envelope:

```json
{
  "data": {},
  "meta": {
    "apiVersion": "1",
    "requestId": "b04d4f0f-413f-4678-921a-2c7b45ed975e",
    "trackerId": "90d814c8-5ec2-4f33-9729-48669f34b701"
  }
}
```

Conserva `meta.requestId` para diagnóstico, pero nunca registres el bearer token en logs.

## Flujo recomendado

1. Consulta `GET /context` para conocer el principal y tracker efectivos.
2. Consulta `GET /trackers`, `GET /accounts` y `GET /categories` para obtener identificadores válidos.
3. Envía `X-Kanan-Tracker-Id` en cada solicitud ligada a un espacio.
4. Usa un `Idempotency-Key` estable en cada escritura.

La sección **API Reference** contiene los parámetros y esquemas de las 27 operaciones disponibles.