Skip to main content
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. 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?

Si trabajas para un solo negocio, usa una clave: es más simple. Lee Claves y permisos. 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.
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.
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.
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.

​
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.
  • Desde tu servidor. El secreto y los tokens nunca van al navegador ni a una app de teléfono. Lee Seguridad.
  • 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.
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.