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

# Apps de terceros

> Cuándo te conviene una app en vez de una clave, cómo se registra y qué ve el propietario del negocio cuando la conecta.

Una **app** es el software de tu empresa conectado a muchos negocios a la vez: un sistema contable, un
agregador de actividades, la herramienta de una agencia que mantiene la web de varios negocios. Cada propietario
la conecta a su negocio desde tu web, en dos clics, eligiendo qué le deja ver o hacer. Tu app nunca ve una
clave del negocio: recibe tokens que vencen, atados a ese negocio y a los permisos que el propietario aceptó.

En estas páginas, **negocio** es un estudio en Craqui, y el **propietario** es quien lo administra. Qué permisos
puede darle a tu app está en [Permisos](https://docs.craqui.com/apps/permissions.md).

La conexión usa OAuth 2.1 con Authorization Code y PKCE. Si ya conectaste una app a Google, a Stripe o a
Shopify, el flujo es el mismo.

## ¿Clave o app?

| | Clave de la API | App |
| - | - | - |
| Para | Un sistema que trabaja para **un** negocio: su web, su caja, su planilla | Un producto que usan **muchos** negocios |
| Quién la crea | El propietario del negocio, en su panel | Tú, una vez, en tu panel |
| Cómo llega a cada negocio | El propietario te pasa la clave | El propietario conecta tu app desde tu web |
| Qué recibe tu sistema | Una clave, que vale hasta que la revoquen | Un access token de 1 hora y un refresh token que rota |
| Permisos | Los que eligió el propietario al crear la clave | Los que tu app pide y el propietario acepta en cada negocio |
| Entorno de prueba | Sí (`crq_test_`) | No: en desarrollo la conectas a tu propio negocio |
| Lo que ve el negocio | El nombre de la clave en la Actividad de la API | El nombre de tu app, en sus aplicaciones conectadas y en la Actividad de la API |

Si trabajas para un solo negocio, usa una clave: es más simple. Lee [Claves y permisos](https://docs.craqui.com/authentication.md).
Si tu producto se conecta a muchos negocios, usa una app: nadie te manda claves por mail, cada negocio ve
quién tiene acceso y puede cortarlo cuando quiera.

## Cómo es, de punta a punta

**1. Registras tu app**

Desde **Configuración → Integraciones → API → Tus aplicaciones** de tu cuenta de Craqui. Recibes un
identificador (`app_…`) y un secreto (`crq_cs_…`), que se muestra una sola vez. Lee
[Crea una app](https://docs.craqui.com/apps/register.md).

**2. La pruebas en tu propio negocio**

Mientras está **en desarrollo**, solo la pueden conectar los propietarios del negocio que la registró, y
solo a negocios donde también son propietarios.

**3. Craqui la revisa**

Cuando funciona, la envías a revisión. Si la aprobamos, la puede conectar el propietario de cualquier
negocio. Lee [Revisión de tu app](https://docs.craqui.com/apps/review.md).

**4. Cada negocio la conecta desde tu web**

Tu web lo manda a la pantalla de Craqui, el propietario elige el negocio y los permisos, y vuelve a tu web
con un código que tu servidor cambia por tokens. Lee [Conectar un negocio](https://docs.craqui.com/apps/authorization-code.md).

**5. Tu servidor llama a la API**

Con el access token, igual que con una clave: `Authorization: Bearer crq_oat_…` contra
`https://api.craqui.com/v1`. Cuando vence, pides otro con el refresh token. Lee [Tokens](https://docs.craqui.com/apps/tokens.md).

## Las reglas de fondo

* **Una conexión, un negocio.** El propietario conecta tu app a un negocio por vez, y los tokens de esa
  conexión solo ven ese negocio. Para otro negocio, se repite el flujo. La respuesta de `/oauth/token` dice
  de qué negocio es cada token (`business_id`).
* **Solo el propietario conecta.** Ni un administrador del negocio ni nadie de Craqui puede conectar tu app
  en nombre del propietario.
* **El propietario elige.** Puede quitarle a tu app cualquier permiso de los que pide, menos ver los datos
  básicos del negocio. Lee [Permisos](https://docs.craqui.com/apps/permissions.md).
* **Desde tu servidor.** El secreto y los tokens nunca van al navegador ni a una app de teléfono. Lee
  [Seguridad](https://docs.craqui.com/apps/security.md).
* **La conexión no vence sola.** Dura hasta que el propietario la desconecta, tu app la revoca o Craqui la
  desconecta por seguridad. Si tu app no la usa en 90 días, el refresh token vence y hace falta conectarla otra vez.

## Lo que ve el propietario

En **Configuración → Integraciones → API**, la primera tarjeta es **Aplicaciones conectadas**. Ahí el
propietario ve, por cada app conectada a su negocio:

* su nombre y, si la aprobamos, la marca **Verificada por Craqui**;
* su estado: activa, en pausa, suspendida o desconectada;
* los permisos que le dio;
* quién la conectó y cuándo, y cuándo la usó por última vez;
* **Ver actividad**: cada pedido de tu app, en la Actividad de la API del negocio;
* **Desconectar**: tu app pierde el acceso en menos de un minuto.

Una conexión queda **en pausa**, sin desconectarse, si el plan del negocio deja de incluir la API o si quien
la conectó deja de ser propietario. Lee [Errores y límites](https://docs.craqui.com/apps/errors.md).

> [!NOTE]
>
> Registrar y conectar apps se habilita negocio por negocio. Si en tu panel no ves **Tus aplicaciones**, o la
> pantalla de conexión dice que todavía no se pueden conectar aplicaciones a ese negocio, escríbenos.


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