Alunta para desarrolladores

Crea lo que adoran tus clientes. Alunta se ocupa de las suscripciones.

Crea tu producto. Alunta se ocupa de las suscripciones. Conecta clientes y acuerdos recurrentes mediante la API.

Prueba Alunta gratisAbrir la documentación de la API

REST API · JSON · OpenAPI

Tu producto y Alunta. Un mismo flujo.
Tu productoCRM · app · tu checkout
REST APIConsultar datos y realizar acciones
AluntaClientes · suscripciones · facturas
WebhooksRecibir avisos cuando algo cambie

Menos trabajo duplicado. Más producto.

Evita dar de alta al mismo cliente en dos sistemas o copiar cifras entre herramientas. Conecta tu producto con Alunta para mantener los datos de las suscripciones dentro de tu flujo de trabajo.

  1. Consulta al cliente donde trabajas

    Consulta las suscripciones desde tu sistema para que ventas y soporte tengan el acuerdo a mano. Utiliza los datos y las referencias de cliente de la API para relacionarlos con los de tus otras herramientas.

    GET /customers

  2. De tu producto a una nueva suscripción

    Deja que los clientes elijan en tu app y compren mediante el checkout de Alunta. Una sesión de checkout y el evento posterior a la compra conectan la experiencia con tu producto.

    POST /checkout-sessions

  3. Conecta el consumo con la factura

    ¿Cobras según el consumo? Envía las mediciones de tu aplicación a Alunta para incluirlas en la facturación de la suscripción. Tu producto registra el uso; Alunta lo relaciona con las condiciones del acuerdo.

    POST /subscriptions/{uuid}/usage

De la idea a la conexión

Tu primera conexión está más cerca de lo que crees.

No hace falta crear toda la integración de una vez. Consulta tus clientes, revisa la respuesta y continúa desde ahí. Ya tienes la documentación y un primer ejemplo.

  1. Prepara el acceso

    Activa el acceso a la API en Alunta y utiliza un token para la cuenta con la que trabajará tu integración. El acceso depende de los permisos del token y de la cuenta asociada.

  2. Consulta tus clientes

    Guarda el token de forma segura en tu servidor como ALUNTA_TOKEN y ejecuta el ejemplo. La petición consulta los datos del cliente sin modificarlos.

  3. Continúa a partir de la respuesta

    Usa los UUID de los clientes para conectar el resto del flujo. La referencia te ayuda a encontrar los campos y las peticiones que necesita tu integración.

Tu primera petición a la API

Este ejemplo utiliza la URL v1 documentada y autenticación bearer. Necesitas un token válido con acceso a clientes en tu cuenta de Alunta.

Lee la guía de inicio
GET /api/v1/customers
curl --request GET \
  'https://app.alunta.com/api/v1/customers' \
  --header "Authorization: Bearer $ALUNTA_TOKEN" \
  --header 'Accept: application/json'

Guarda el token en la variable de entorno ALUNTA_TOKEN de tu servidor. Evita incluirlo en el código fuente, enviarlo al navegador o escribirlo en los registros.

Cuando cambian tus datos

Deja que tus sistemas se mantengan al día.

Cuando cambia una suscripción o se registra un pago, tu producto puede recibir un aviso y ejecutar el siguiente paso. Los webhooks permiten reaccionar a esos eventos sin consultar la API repetidamente.

Elige los eventos necesarios y recíbelos en tu endpoint HTTPS. La documentación contiene los detalles de las firmas, las entregas y los reintentos.

  1. Verifica quién lo envía

    Comprueba la firma documentada sobre el cuerpo original de la petición antes de procesar el evento.

  2. Responde antes de procesar el trabajo

    Confirma la recepción y procesa el trabajo posterior en una cola. Consulta en la documentación el tiempo máximo de respuesta.

  3. Gestiona los reintentos

    Un evento puede recibirse más de una vez. Evita que una entrega repetida active la misma acción otra vez.

Dale a tu asistente de código una buena base.

¿Programas con un asistente de código? Dale el archivo OpenAPI y la documentación de Alunta para que utilice los endpoints y las respuestas correctas. Tendrás un punto de partida concreto para la integración y más tiempo para tu propio código.

Referencia interactiva

Endpoints, campos y respuestas.

Abrir el recurso

OpenAPI · YAML

La especificación para tus herramientas.

Abrir el recurso

llms.txt

Una guía para tu asistente de código.

Abrir el recurso

Identifica el error y el siguiente paso.

Una respuesta de la API te indica el siguiente paso. Estos son tres mensajes habituales y lo que puedes hacer.

401 / 403Comprueba el acceso
Revisa el token, sus permisos y si el módulo de API está disponible en la cuenta.
422Comprueba el contenido
Lee el error de validación y los requisitos del endpoint para los campos y las acciones.
429Respeta el límite de peticiones
Respeta Retry-After y limita las peticiones simultáneas. Las consultas y las escrituras tienen cuotas independientes.

¿Te has atascado? Envíanos la X-Request-Id para que podamos localizar la petición. Encontrarás las peticiones y los errores en Ajustes → API → Registro. No compartas tu token.

Elige la conexión adecuada para cada tarea.

API

Cuando tu propio código necesita consultar datos o realizar una acción documentada en Alunta.

Busca tu endpoint

MCP

Cuando un asistente de IA compatible debe utilizar información y herramientas seleccionadas de tu cuenta.

Ver acceso a la IA

Integraciones y Zapier

Cuando una conexión o un flujo existente puede hacer el trabajo por ti.

Buscar una integración

Buenas preguntas. Vamos a resolverlas.

¿Puede la API trabajar con todas mis cuentas de Alunta?

Un token concede acceso a la cuenta asociada y a las acciones permitidas por sus permisos. Planifica la conexión de la cuenta en tu integración. Usa /me para consultar el contexto de la cuenta autenticada.

¿Puedo usar la API desde un navegador?

Guarda el token en el servidor. Haz que el servidor llame a Alunta y pasa a la interfaz solo la información que necesita. No incluyas el token de API en código público del navegador.

¿Qué pasa si necesito otro endpoint?

Cuéntanos el flujo y la información o la acción que necesitas. Estaremos encantados de estudiar la posibilidad. La referencia pública muestra lo que puedes crear hoy.

¿Podéis ayudarme con mi integración?

Sí. Escribe a support@alunta.com con el proceso que quieres conectar, el endpoint, el código de estado HTTP y la X-Request-Id, si la tienes. No incluyas tokens ni datos sensibles de clientes. El equipo atiende en danés e inglés.

¿Qué quieres conectar con Alunta?

¿Tienes una idea, una tarea manual frustrante o una integración que quieras crear? Habla con nosotros. Te ayudamos a encontrar una buena conexión entre tu producto y Alunta.

Construyamos juntos la conexión

Empieza por la API

Usa la API documentada para las operaciones de clientes y suscripciones disponibles. Protege las credenciales.

Recibe avisos con webhooks

Recibe eventos compatibles mediante webhooks. Prevé reintentos y valida las solicitudes entrantes.

Prueba el proceso completo

Prueba el proceso completo antes del lanzamiento. Consulta las operaciones y límites en la documentación.