# Uso de tokens

Fuente: /authentication/using-token/

Una vez que hayas obtenido tu token, el siguiente paso es integrarlo en tus peticiones HTTP para autenticarte correctamente con nuestra API.

**Propósito**

Autenticar y autorizar el acceso a todos los endpoints protegidos.

**Caducidad**

 1 Año

Tras este periodo, deberás generar uno nuevo.

***

### Configuración del Encabezado

Todas las solicitudes a la API deben incluir el token en la cabecera (header) utilizando la clave `X-Api-Key`.

| Encabezado | Valor | Descripción |
| :- | :- | :- |
| **X-Api-Key** | `{tu_token}` | Tu Customer ID y Secret concatenados (`ID:Secret`) |

> **Precaución**
>
> Nunca compartas tu token públicamente ni lo incluyas en código del lado del cliente (Frontend) expuesto.

***

### Ejemplos de Implementación

A continuación se muestra cómo incluir el encabezado en diferentes lenguajes y herramientas:

**cURL**

```bash
curl -X GET "https://api.verificamex.com/v1/some-endpoint" \
     -H "X-Api-Key: ac110005-9b0b-1806:5cc0e85091f11b02..."
```

**JavaScript (Fetch)**

```javascript
fetch("https://api.verificamex.com/v1/some-endpoint", {
  method: "GET",
  headers: {
    "X-Api-Key": "ac110005-9b0b-1806:5cc0e85091f11b02...",
    "Content-Type": "application/json"
  }
});
```

**Python (Requests)**

```python
import requests

url = "https://api.verificamex.com/v1/some-endpoint"
headers = {
    "X-Api-Key": "ac110005-9b0b-1806:5cc0e85091f11b02..."
}

response = requests.get(url, headers=headers)
print(response.json())
```

**¿Aún no tienes un token?**

Si todavía no has generado tus credenciales, puedes hacerlo en pocos segundos desde el panel de configuración.

[Ver guía: Generar token](/authentication/generate-tokens)