# API Pública

> Documentacion publica para integraciones externas de Goil.

## Docs

- [Actualizar cuenta](https://docs.goil.app/api-reference/account/actualizar-cuenta.md): Actualiza teléfono y/o atributos. Requiere `x-client-id`.
- [Comprobar cuenta](https://docs.goil.app/api-reference/account/comprobar-cuenta.md): Comprueba si existe una cuenta por teléfono o por tags. Requiere `x-client-id`. Debe enviarse `phone` o al menos un elemento en `tags`.
- [Crear cuenta](https://docs.goil.app/api-reference/account/crear-cuenta.md): Registra una nueva cuenta (usuario externo). Requiere `x-client-id`.
- [Eliminar cuenta](https://docs.goil.app/api-reference/account/eliminar-cuenta.md): Marca la cuenta como eliminada.
- [Listar cuentas](https://docs.goil.app/api-reference/account/listar-cuentas.md): Lista cuentas por IDs. Query param `accountIds` (array). Requiere `x-client-id`.
- [Obtener cuenta](https://docs.goil.app/api-reference/account/obtener-cuenta.md): Devuelve una cuenta por ID. Recomendado enviar `x-client-id`.
- [Obtener cuenta (plural path)](https://docs.goil.app/api-reference/account/obtener-cuenta-plural-path.md): Mismo que GET /account/:accountId. Recomendado usar /account/:accountId.
- [Actualizar alerta (geo constant)](https://docs.goil.app/api-reference/alert/actualizar-alerta-geo-constant.md): Actualiza ubicación/estado de una alerta. Requiere Bearer + x-client-id.
- [Crear alerta](https://docs.goil.app/api-reference/alert/crear-alerta.md): Crea una alerta geolocalizada. Requiere autenticación Bearer (token de login) y contexto de negocio. El cuerpo incluye `account` con `typeId` y opcionalmente `tag`/`value` para resolver el accountId.
- [Login externo](https://docs.goil.app/api-reference/authentication/login-externo.md): Obtiene un accessToken para el cliente. El `businessId` puede ir en body o en header `x-client-id`.
- [Enviar notificación](https://docs.goil.app/api-reference/notification/enviar-notificación.md): Envía notificación push (y opcionalmente WhatsApp). Requiere `x-client-id`. Exactamente uno de `phones`, `accountIDs` o `accountTypeIDs` debe estar presente.
- [API Pública](https://docs.goil.app/index.md): Documentación de la API pública para integraciones externas

## OpenAPI Specs

- [external-v1](https://docs.goil.app/openapi/external-v1.yaml)
- [openapi](https://docs.goil.app/api-reference/openapi.json)