> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Registros de API

> Aprenda a consultar el historial de llamadas de API para auditar integraciones y depurar errores.

<Tip>
  Los registros de API son su **extracto bancario** de integración: cada llamada HTTP se registra con solicitud, respuesta y estado. Cuando algo se rompe, ves exactamente lo que entró y lo que devolvió la API.
</Tip>

## ¿Qué son los registros API?

Son el historial de **cada llamada** realizada a la API en su espacio de trabajo: método, punto final, cuerpo de la solicitud, respuesta y estado HTTP.

Piense en el extracto de una tarjeta: no muestra si el mensaje llegó al cliente, pero muestra **cada transacción** entre su sistema y Notifique.

## ¿Para qué sirven?

Con los registros puedes:

* **Depurar** errores 401, 403 o 400 en tu integración
* **Auditar** qué clave API realizó cada llamada
* **Ver** solicitud y respuesta exactas (con datos confidenciales enmascarados)
* **Filtrar** por estado, método, fecha o clave
* **Compruebe** con \[Respuestas de error]\(/es/guides/conceitos/resposta-de-erros para entender el `code` devuelto

## Registros frente a webhooks

Se complementan entre sí; uno no reemplaza al otro:

| Situation                                 | API logs | Webhooks |
| ----------------------------------------- | -------- | -------- |
| Understand why the API returned 403       | **Yes**  | No       |
| Know which key made the call              | **Yes**  | No       |
| See HTTP request and response             | **Yes**  | No       |
| Know if the message reached the customer  | No       | **Yes**  |
| React in real time to delivery or failure | No       | **Yes**  |

<Note>
  Los **webhooks** notifican lo que sucedió con un **mensaje** (entregado, fallido, leído). **Registros de API** registran **quién llamó a la API** y qué devolvió la API en el momento de la solicitud.
</Note>

## Cómo consultar

### En el tablero

1. Abra **Registros** en la barra lateral (o desde **Centro de desarrolladores**)
2. Seleccione el espacio de trabajo (si tiene más de uno)
3. Filtrar por estado, método o fecha
4. Haga clic en un elemento para ver la solicitud y la respuesta completas.

### A través de API

#### 1. Permiso

La clave necesita alcance **`logs:read`**. Los registros se limitan al **espacio de trabajo** de la clave.

#### 2. Listar registros

Devuelve el historial paginado del espacio de trabajo.

Paginated response (`pagination.total`, `pagination.page`, `pagination.limit`, `pagination.totalPages`). Each item includes:

| Field                          | What it is                                 |
| ------------------------------ | ------------------------------------------ |
| `endpoint`                     | Path called (e.g. `/v1/whatsapp/messages`) |
| `method`                       | `GET`, `POST`, etc.                        |
| `status`                       | HTTP status returned                       |
| `requestBody` / `responseBody` | JSON sent and received                     |
| `requestQuery`                 | Query string, when present                 |
| `duration`                     | Request time in ms                         |
| `apiKeyId`                     | Key that made the call                     |
| `instanceId`                   | Related instance, if any                   |
| `userAgent` / `ip`             | Request metadata                           |
| `createdAt`                    | UTC timestamp                              |

#### 3. Filter results

| Parameter                   | Use                                                         |
| --------------------------- | ----------------------------------------------------------- |
| **page**                    | Page number (default 1)                                     |
| **limit**                   | Items per page (max 100)                                    |
| **status**                  | HTTP codes comma-separated (e.g. `200,202,403`)             |
| **startDate** / **endDate** | ISO 8601 range                                              |
| **method**                  | e.g. `GET,POST`                                             |
| **apiKeyId**                | Filter by workspace key (must belong to the same workspace) |

Example filtering 403 errors on POST:

<Warning>
  Tokens and sensitive data in logs appear as `[REDACTED]` before storage. See \[Security and reliability]\(/es/guides/conceitos/seguranca-e-confiabilidade.
</Warning>

***

## Próximos pasos

* [Respuestas de error](/es/guides/conceitos/resposta-de-erros): códigos HTTP y `code`
* [Claves API](/es/guides/api-key/index): alcances y `logs:read`
* [Webhooks](/es/guides/webhooks/index): estado de entrega en tiempo real
* [Espacios de trabajo](/es/guides/workspaces/index): donde se encuentran los registros del espacio de trabajo