Saltar al contenido
LinkProfit

La API en general

API REST v1 para enlaces, analíticas, dominios y operaciones de partner: URL base, tipos de clave, alcances y modelo de marca blanca.

Actualizado el 13 de agosto de 2026

Todo lo que hace el panel lo hace también la API: crear enlaces con segmentación y repartos A/B, leer analíticas, conectar dominios, gestionar clientes y planes. La API es una superficie de producto de primera clase: el panel y la API ejecutan el mismo código y aplican los mismos límites.

URL base

https://api.linkprofit.com/v1

Todas las solicitudes usan HTTPS y JSON. Las respuestas son JSON salvo la imagen del QR y la exportación CSV. La referencia interactiva, siempre al día, está en /docs/api/reference y se genera a partir de los mismos esquemas que validan cada solicitud.

Dos tipos de clave

| Prefijo de clave | Alcance | Se crea en | Da acceso a | |---|---|---|---| | lp_live_… | Espacio de trabajo | Ajustes del espacio → Claves de API | /links, /analytics, /domains, /workspace, /events, /webhooks | | lpp_live_… | Partner | Ajustes del partner → Claves de API | /partner/* y /webhooks |

Una clave de espacio de trabajo actúa dentro de un espacio de cliente. Una clave de partner gestiona la cuenta de partner: clientes, planes, dominios y pagos. Las claves llevan alcances que limitan lo que puede hacer cada una.

Versionado

La v1 está congelada: los campos solo se añaden, nunca se renombran ni se eliminan. Los cambios incompatibles saldrían como /v2. Programa contra los campos documentados e ignora los desconocidos.

Marca blanca: ofrecer la API a tus clientes

Si llevas un servicio de enlaces de marca blanca, la API forma parte de lo que revendes:

  • Las claves las repartes tú. Cada cliente crea claves de espacio de trabajo en su propio panel de marca (Ajustes → Claves de API); tu clave de partner no se comparte nunca.
  • El host sigue siendo compartido. En la v1, todo el tráfico de la API va a api.linkprofit.com: todavía no hay dominio de API propio por partner. Documenta la URL base como «el host de la API de tu servicio»; las respuestas no llevan ninguna marca de LinkProfit.
  • Los límites siguen a tus planes. El acceso a la API es un indicador de función en los planes que vendes (api_access), y el límite de solicitudes de cada clave viene del plan. Un cliente en un plan sin acceso a la API recibe 403 plan_restricted.

Consulta la guía de marca blanca para una página lista para copiar y adaptar a tu propia documentación para desarrolladores.

Referencias rápidas