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

# Integrarse con la API

> Autenticación y primera consulta a la API externa de IsProp.

## Dominio y autenticación

La API se utiliza desde el dominio de tu tenant, seguido de `/api/v1`. Reemplazá `tenant.example.com` por tu dominio real. El dominio de documentación no es el servidor API.

Solicitá un token Sanctum a un administrador autorizado y enviá las cabeceras `Authorization: Bearer TU_TOKEN` y `Accept: application/json`. El token debe tener los permisos necesarios para cada operación. Conservá los tokens en el servidor cuando la integración requiera acceso privado.

## Primera consulta

```bash theme={null}
curl 'https://tenant.example.com/api/v1/units' \
  -H 'Authorization: Bearer TU_TOKEN' \
  -H 'Accept: application/json'
```

```php theme={null}
$response = Http::withToken($token)
    ->acceptJson()
    ->get('https://tenant.example.com/api/v1/units');
```

```javascript theme={null}
const response = await fetch('https://tenant.example.com/api/v1/units', {
  headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' }
});
const data = await response.json();
```

## Listados y errores

Consultá los parámetros de cada endpoint para sus filtros y paginación: no todos los recursos admiten los mismos campos. Los listados paginados incluyen información para recorrer sus páginas.

| Código | Revisar |
| - | - |
| 401 | Token ausente, vencido o inválido. |
| 403 | Permisos o capacidades insuficientes. |
| 404 | Recurso o dominio del tenant incorrecto. |
| 422 | Campos y reglas de validación informadas en la respuesta. |
| 429 | Límite de solicitudes; esperar antes de reintentar. |

El playground realiza solicitudes reales. Utilizá un tenant de demostración para explorar operaciones que crean, modifican o eliminan datos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.