API REST para desarrolladores
Una API de enlace en la biografía para aplicaciones y automatizaciones
Conecta herramientas internas, campañas y aplicaciones para creadores a Biolinky mediante una API REST versionada. Usa el mismo modelo de permisos de MCP cuando necesites peticiones HTTP directas y respuestas JSON previsibles.
Respuesta rápida
La API de Biolinky permite que una aplicación autorizada consulte y gestione el contenido de la página mediante código. Está diseñada con autenticación bearer explícita, acceso limitado a la página, validación de datos y credenciales revocables.
- Endpoints REST versionados con documentación OpenAPI 3.1
- Autenticación bearer con tokens OAuth o claves personales
- Idempotencia y control de versiones para cambios más seguros
- Límites de uso e ID de solicitud para supervisar integraciones
API o MCP para enlaces en la biografía: ¿cuál usar?
Usa la API REST cuando tu código ya sepa qué operación realizar. Una tarea programada, una herramienta interna o un panel propio pueden llamar a un endpoint documentado y procesar una respuesta JSON tipada. REST encaja con el desarrollo convencional y los flujos entre servidores.
Usa MCP cuando un cliente de IA deba descubrir herramientas y elegir la llamada adecuada a partir de instrucciones en lenguaje natural. Ambos accesos usan la misma página y el mismo principio de autorización limitada. Muchos sistemas combinan REST para tareas deterministas de producción y MCP para agentes supervisados.
Ninguna opción exige compartir la contraseña habitual. La integración usa un token independiente con permisos limitados, caducidad, renovación y revocación.
Qué puedes crear con la API de Biolinky
La API es útil cuando la página de enlaces es el último paso de un flujo más amplio. Una plataforma puede actualizar un destino aprobado al lanzar una campaña. Una herramienta para creadores puede combinar estadísticas y datos de publicación. Un sistema de marca puede mantener textos y destinos sociales alineados con una fuente oficial.
Mantén las integraciones explícitas. Consulta la página actual, usa sus identificadores y versión, envía solo los cambios deseados y guarda el ID devuelto si necesitas auditar o depurar una tarea.
- Sincroniza una URL de campaña aprobada desde un CMS interno.
- Crea, edita, reordena, archiva y restaura enlaces.
- Mantén textos del perfil y destinos sociales alineados entre sistemas.
- Consulta estadísticas recientes de la página y los enlaces para informes.
- Crea una interfaz propia sobre una conexión limitada al creador.
Un patrón de integración fiable
Crea una credencial exclusiva para cada entorno y finalidad. Guárdala en el gestor de secretos de tu plataforma, nunca en JavaScript del navegador. Antes de modificar, consulta el recurso y conserva su versión. Usa una clave de idempotencia al reintentar creaciones para evitar duplicados tras fallos de red.
Gestiona de forma deliberada los límites y conflictos. Espera antes de reintentar cuando la API pida reducir el ritmo y vuelve a consultar un recurso si cambia su versión. Registra ID y resultados generales, pero oculta cabeceras de autorización y contenido que no necesites conservar.
- Paso 1
Crea una credencial con permisos limitados
Limita el acceso a la página y a los permisos mínimos necesarios.
- Paso 2
Lee el contrato de la API
Usa el documento OpenAPI publicado como referencia para las peticiones.
- Paso 3
Implementa reintentos seguros
Usa claves de idempotencia, versiones, esperas progresivas e ID de solicitud.
- Paso 4
Renueva y supervisa
Revisa el uso y revoca credenciales cuando termine la integración.
Lista de seguridad de la API de enlace en la biografía
Trata la clave de Biolinky como cualquier secreto de producción. Envíala solo por HTTPS en la cabecera Authorization. No la incluyas en parámetros de URL, eventos de analítica, almacenamiento del navegador, mapas de código, capturas, gestores de incidencias ni ejemplos guardados en repositorios.
Usa OAuth cuando una aplicación conecte páginas de otros usuarios, para que cada persona revise y apruebe el acceso. Las claves personales son para herramientas fiables del titular. En ambos casos, aplica tu propia autorización a cualquier interfaz que pongas delante de la API.
Preguntas frecuentes
- ¿Biolinky tiene una API REST?
- Sí. Biolinky ofrece endpoints REST versionados y un documento OpenAPI 3.1 para operaciones autorizadas de perfil, enlaces, redes y estadísticas.
- ¿Dónde está la documentación de la API de Biolinky?
- El documento OpenAPI legible por máquinas está en /api/v1/openapi.json. La guía de configuración y autorización está en la página de API y MCP.
- ¿Puedo usar la API desde el navegador?
- No expongas claves personales en código del navegador. Llama a la API desde un servidor fiable o usa un flujo OAuth diseñado para autorización del usuario.
- ¿Qué diferencia hay entre una clave de API y OAuth?
- Una clave personal la crea el titular para una herramienta fiable. OAuth permite que un cliente externo solicite acceso y el usuario lo apruebe desde Biolinky.
Fuentes y lecturas recomendadas
Sigue explorando