SDK (Kit de Desarrollo de Software)

Un SDK (Software Development Kit) es un paquete listo para usar de bibliotecas de código, herramientas y documentación que convierte una API en funciones para un lenguaje de programación. En lugar de escribir peticiones HTTP a mano, los desarrolladores llaman a funciones ya preparadas.

¿Qué es un SDK?

Un SDK (Software Development Kit) es un paquete listo para usar de bibliotecas de código, herramientas y documentación para un lenguaje de programación. Convierte una API en funciones que los desarrolladores llaman directamente. En lugar de construir peticiones HTTP a mano, leer respuestas JSON y gestionar los errores por su cuenta, basta con una línea como client.messages.send(). El SDK se encarga del resto.

Hay dos variantes. Un SDK ligero refleja los endpoints de la API uno a uno y añade sobre todo tipos. Un SDK completo añade comodidad, como reintentos automáticos, paginación o la verificación de firmas de webhooks. Cada SDK está ligado a un solo lenguaje: un proveedor que quiera dar servicio a desarrolladores de Python, JavaScript y PHP tiene que crear y mantener tres paquetes distintos.

¿SDK o REST API directa?

Un SDK siempre es una capa sobre una API, normalmente una REST API. Los dos caminos llevan al mismo resultado. La diferencia está en el esfuerzo:

  • Con SDK: primeros pasos más rápidos, funciones tipadas y menos errores en el código. A cambio, dependes de que el proveedor mantenga el paquete al día para tu lenguaje y tu versión.
  • Directamente por REST: funciona en cualquier lenguaje que pueda enviar peticiones HTTP, sin paquetes adicionales. Ves exactamente lo que se transmite, pero la autenticación, la gestión de errores y los reintentos los escribes tú.

Para la mayoría de las integraciones de mensajería bastan unas pocas llamadas REST directas: autenticarse, enviar un mensaje, recibir actualizaciones de estado. Por eso muchos equipos prescinden de los SDK o generan su propio cliente a partir de la descripción de la API.

Tu propio cliente a partir de una especificación OpenAPI

Muchas API publican una especificación OpenAPI: un archivo legible por máquinas que describe cada endpoint, cada parámetro y cada respuesta. Con ese archivo obtienes buena parte de lo que ofrece un SDK, sin esperar a un paquete oficial:

  • Generar código cliente: herramientas como OpenAPI Generator crean a partir de la especificación un cliente tipado para tu lenguaje.
  • Probar en herramientas de API: Postman, Insomnia o Bruno importan la especificación, así puedes probar cada endpoint antes de escribir código.
  • Usar herramientas de programación con IA: asistentes como Claude Code, Cursor o GitHub Copilot leen la especificación y la documentación y escriben el código de integración para tu stack.

SDK en SendSeven

SendSeven no ofrece SDK por lenguaje para su REST API. El único SDK es el SDK de push: un pequeño fragmento de código que añade notificaciones push del navegador a tu propio sitio web. Para todo lo demás te conectas directamente a la REST API, con estas ayudas:

  • Especificación OpenAPI: generar código cliente o importarla en Insomnia o Bruno.
  • Colección de Postman: peticiones ya preparadas para probar los endpoints.
  • Documentación para herramientas de programación con IA: cada página de docs.sendseven.com está disponible también en Markdown, junto con un prompt listo para Claude Code, Cursor y GitHub Copilot.
  • Servidor MCP: los agentes de IA como Claude trabajan directamente con SendSeven.
  • Sin código: Zapier, Make y n8n conectan SendSeven con otras herramientas sin programar.

La autenticación se hace con una clave API que se envía como token Bearer. Tienes las instrucciones paso a paso en la guía de autenticación de la API y todos los endpoints en la documentación para desarrolladores.