Ofrecer la API a tus clientes

Tus clientes pueden automatizar sus enlaces igual que tú automatizas tu cuenta de partner. Esta página es el manual para convertir la API en una función de tu producto, incluido el texto que puedes adaptar para tu propia documentación de desarrollo.

Cómo funciona

• Los clientes crean sus propias claves. Todo espacio de trabajo con un plan que incluya acceso a la API tiene Ajustes → Claves de API en el panel de marca. Las claves pertenecen al espacio de trabajo: tu clave de partner no interviene nunca, y un cliente solo puede llegar a sus propios datos.
• El host es compartido. Todas las solicitudes van a https://api.linkprofit.com/v1. En la v1 no hay dominio de API propio por partner: documenta el host como el endpoint técnico de tu servicio. Las respuestas no llevan ninguna marca de LinkProfit: los dominios, enlaces y analíticas de los payloads son los de tu cliente.
• Tú controlas quién lo tiene. El acceso a la API es el indicador api_access en los planes que vendes. Los clientes en planes sin ese indicador reciben 403 plan_restricted, un momento limpio para el upsell. Los límites de solicitudes siguen a la clave, así que un plan más caro puede salir con un límite más alto.

Qué poner en tu documentación

Una página de desarrollo mínima para tus clientes necesita cuatro cosas:

1. Dónde están las claves: «Ajustes → Claves de API en tu panel; la clave se muestra una sola vez».
2. La URL base: https://api.linkprofit.com/v1, con autenticación mediante Authorization: Bearer <clave>.
3. Un inicio rápido: copia el Inicio rápido y sustituye el dominio de ejemplo por uno tuyo.
4. La referencia: enlaza la referencia interactiva o aloja el archivo OpenAPI (https://linkprofit.com/openapi.json) en tu propia herramienta de documentación; se renderiza tal cual en Scalar, Swagger UI, Redoc y Postman.

Webhooks para clientes

Los espacios de trabajo de cliente registran sus propios endpoints de webhook para eventos de enlaces, dominios y umbrales de clics. Los eventos de nivel de partner —suscripciones y pagos— se quedan en tus endpoints de partner y no se entregan nunca a los clientes.

Límites que conviene mencionar

• Las claves son por espacio de trabajo: un cliente de agencia que gestione varios espacios crea una clave en cada uno.
• El registro de auditoría atribuye los cambios de la API a la clave, y el cliente lo ve en su panel: las conversaciones con soporte empiezan con hechos.
• Todo lo que escribe la API obedece las mismas cuotas de plan que el panel: un cliente no puede saltarse por script el límite de enlaces que le vendiste.