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

# API Reference

> Documentación completa de la API de Facturear

# 🔌 API Reference

Bienvenido a la documentación completa de la API de Facturear. Aquí encontrarás toda la información necesaria para integrar tu sistema con nuestra plataforma de facturación electrónica.

## 🚀 Comenzar con la API

### Autenticación

Todas las peticiones requieren autenticación usando:

* **Sesión Web**: Para aplicaciones basadas en navegador
* **API Key**: Para integraciones servidor a servidor

Incluye tu API key en el header `x-api-key`:

```bash theme={null}
x-api-key: tu-api-key-aqui
```

#### 🔑 API Keys por Ambiente

Facturear utiliza la misma URL base pero diferentes API keys para distinguir entre ambientes:

**Testing (Homologación)**

* **Prefijo API Key**: `test_sk_`
* **Propósito**: Pruebas y desarrollo
* **Datos**: Ambiente de homologación ARCA, no genera facturas reales
* **Límites**: Más permisivo para testing

**Producción**

* **Prefijo API Key**: `prod_sk_`
* **Propósito**: Ambiente real de facturación
* **Datos**: Genera facturas electrónicas reales con validez fiscal
* **Límites**: Restricciones de rate limiting estrictas

<callout type="warning">
  ⚠️ **Importante**: Nunca uses tu API key de producción (`prod_sk_`) para testing. Las facturas generadas en producción son reales y tienen validez fiscal.
</callout>

#### 📋 Obtener tu API Key

1. **Accede a tu dashboard** en [facture.ar](https://facture.ar)
2. **Ve a Claves APIs**
3. **Genera una nueva API key** para el ambiente que necesites
4. **Copia y guarda** tu API key de forma segura

<info>
  ⚠️ **Tip**: Puedes regenerar tu API key en cualquier momento. Solo asegurate de guardar la nueva key, la anterior se perdera.
</info>

### URL Base

La URL base es la misma para todos los ambientes:

```
https://facture.ar/api
```

<info>
  💡 **Nota**: El ambiente (testing/producción) se determina automáticamente por tu API key, no por la URL.
</info>

## 🎮 Playground Interactivo

Prueba la API directamente desde la documentación usando nuestro playground interactivo:

* **Prueba endpoints en tiempo real**: Envía peticiones reales y ve las respuestas
* **Ejemplos de código**: Genera código en múltiples lenguajes (cURL, JavaScript, Python, PHP)
* **Autenticación integrada**: Configura tu API key una vez y úsala en todas las pruebas
* **Ambiente seguro**: Usa tu API key de testing para experimentar sin riesgos

[Explorar Playground](/es/api-reference/playground)

## 📞 Soporte

Si necesitas ayuda con la API:

* 📧 **Email**: [support@facture.ar](mailto:support@facture.ar)
* 💬 **Chat**: Disponible en la plataforma
* 📚 **Documentación**: Explora nuestros ejemplos detallados
* 🎥 **Videollamada**: Para asistencia personalizada