Arquitectura de API REST

Un API REST unificada para todos los canales

Deja de hacer malabares con múltiples implementaciones de API. Unipile proporciona un esquema de API REST único y coherente que funciona en LinkedIn, WhatsApp, Gmail, Outlook y las principales plataformas de comunicación. Escribe una vez, integra en todas partes.

Construir Referencia API

unified-api.js

// Una estructura de solicitud para todos los proveedores

const response = await

fetch(https://api.unipile.com/api/v1/messages, {

method: POST,

headers: { 'Authorization': 'Bearer YOUR_TOKEN' },

body: JSON.stringify({

account_id: "acc_123",

attendees: [{ identifier: "contact@example.com" }],

text: "Hello from Unipile!"

})

});

// La misma estructura funciona para:

// LinkedIn - WhatsApp - Gmail - Instagram - Telegram

200 OK - Mensaje enviado

Por qué es importante la unificación

El poder de un Esquema unificado

Compruebe la diferencia entre mantener varias integraciones de API y utilizar un esquema unificado. Menos código, menos errores, desarrollo más rápido.

API nativas Complejo

linkedin-message.js

                            const linkedin = require(linkedin-api-client);
                            await linkedin.messages.create({
                              recipients: [urn:li:persona:abc123],
                              body: { text: message },
                              messageType: 'MEMBER_TO_MEMBER'
                            });
                        

whatsapp-message.js

                            await fetch(`https://graph.facebook.com/v18.0/${PHONE_ID}/messages`, {
                              method: POST,
                              body: JSON.stringify({
                                messaging_product: whatsapp,
                                to: phoneNumber,
                                tipo: texto,
                                text: { body: message }
                              })
                            });
                        

gmail-message.js

Gmail

                            const gmail = google.gmail({ versión: 'v1'auth });
                            const en bruto = Tampón.from(
                              `Para: ${to}\r\nSubject: ${subject}\r\n\r\n${body}`
                            ).toString(base64);
                            await gmail.usuarios.mensajes.send({
                              userId: yo, requestBody: { raw }
                            });
                        

Con Unipile Recomendado

enviar-mensaje.js

Todos los proveedores

                            // Una función para TODAS las plataformas de mensajería
                            async function sendMessage(accountId, recipient, text) {
                              return fetch(`https://api.unipile.com/api/v1/messages`, {
                                method: POST,
                                headers: {
                                  'Authorization': `Bearer ${API_KEY}`,
                                  'Content-Type': aplicación/json
                                },
                                body: JSON.stringify({
                                  account_id: accountId,
                                  attendees: [{ identifier: recipient }],
                                  text: text
                                })
                              });
                            }
                            // Funciona para: LinkedIn, WhatsApp, Gmail, Instagram...
                        

API nativas

SDK diferente para cada plataforma

Formatos de datos y respuestas incoherentes

Flujos de autenticación separados para gestionar

3 veces más código que escribir y mantener

Con Unipile

Código base único para todos los proveedores

Gestión de errores y respuestas unificadas

Añadir nuevos canales sin cambiar el código

90% menos código que mantener

90%

Menos código que escribir
y mantener

1 semana

Tiempo medio de integración
frente a meses con API nativas

0

Cambios de última hora
al añadir nuevos proveedores

Empiece a construir con la API unificada

Todo lo que necesitas, Una API

Desde la mensajería hasta los calendarios, acceda a todas las funciones de comunicación a través de puntos finales REST coherentes y bien documentados. Misma estructura, mismas respuestas, en todos los proveedores.

Mensajería

Envía, recibe y gestiona mensajes en LinkedIn, WhatsApp, Instagram y Telegram.

GET POST PUT BORRAR

/api/v1/mensajes

/api/v1/chats/{chat_id}

Correo electrónico

Gestión completa del correo electrónico con Gmail, Outlook e IMAP. Envía, lee, organiza y realiza un seguimiento de los correos electrónicos.

GET POST PUT BORRAR

/api/v1/emails

/api/v1/emails/{email_id}

Calendario

Gestiona eventos, horarios y disponibilidad en Google Calendar y Outlook Calendar.

GET POST PUT BORRAR

/api/v1/calendario/eventos

/api/v1/calendario/disponibilidad

Perfiles

Acceda a información de contacto, perfiles de LinkedIn, datos de empresas y perspectivas de relaciones.

GET POST

/api/v1/usuarios/{identificador}

/api/v1/empresas/{id}

Puestos

Crear y gestionar publicaciones en LinkedIn e Instagram. Gestión de comentarios, reacciones y participación.

GET POST BORRAR

/api/v1/posts/{post_id}

/api/v1/posts/{post_id}/comentarios

Admin

Gestione cuentas y webhooks mediante programación. Gestión de conexiones, autenticación y eventos.

GET POST BORRAR

/api/v1/cuentas

/api/v1/webhooks

Todos los proveedores

Explorar la referencia API

Construido para Desarrolladores

Una API lista para la producción con fiabilidad empresarial. Envíe más rápido, mantenga menos, escale con confianza.

Ahorrar semanas de desarrollo

Deje de construir infraestructuras. Céntrese en su producto mientras nosotros nos encargamos de la complejidad.

Sin Unipile

Crear flujos de autenticación por proveedor

Mantener cada integración

Gestionar los cambios de última hora de la API

Gestione usted mismo los límites de tarifa

Con Unipile

Autenticación alojada lista para usar

Mantenimiento cero

Nos encargamos de todas las actualizaciones

Gestión inteligente de los límites de velocidad

Acceso directo a la API, sin raspado

Conexiones API con todos los proveedores. Respuestas más rápidas, mayor fiabilidad, sin riesgo de bloqueo.

Diseño RESTful limpio

Puntos finales intuitivos que siguen las mejores prácticas REST. URL basadas en recursos, métodos HTTP estándar, códigos de estado adecuados.

Gestión inteligente de límites de tarifa

Gestión automática del límite de tarifa en todos los proveedores. Ponemos en cola, reintentamos y optimizamos las solicitudes para que usted no tenga que hacerlo.

Documentación exhaustiva

Guías detalladas, ejemplos de código y referencias de API para cada punto final. Empiece en cuestión de minutos, no de días.

Explorador interactivo de API

Copiar y pegar fragmentos de código

Tutoriales paso a paso

Alto rendimiento

Tiempos de respuesta rapidísimos y fiabilidad probada. Construido sobre una infraestructura global para la velocidad en todas partes.

Latencia ultrabaja

99,9% de tiempo de actividad durante 24 meses

Distribución mundial de CDN

Seguridad de las empresas

Cifrado de nivel bancario, OAuth 2.0 y conformidad con SOC 2. Tus datos y los de tus usuarios permanecen protegidos.

Conformidad con el GDPR

Conformidad con SOC 2

Gestión segura de fichas

Abstracción de proveedores sin pérdida de prestaciones

La mayoría de las capas de agregación aplanan las características. Unipile no lo hace. La API REST está diseñada para exponer funciones específicas del proveedor cuando sea necesario, mantener la coherencia de los puntos finales comunes y permitir la adopción progresiva de funciones avanzadas.

Puntos finales compartidos para operaciones comunes

Una vista de bandeja de entrada básica utiliza puntos finales compartidos en todos los proveedores para un comportamiento coherente.

Rutas específicas de proveedores para funciones avanzadas

Las acciones avanzadas de LinkedIn están disponibles a través de rutas dedicadas cuando las necesites.

Datos brutos del proveedor cuando sea necesario

El acceso a los datos brutos del proveedor está siempre disponible cuando se necesita un control total o metadatos específicos.

Ejemplo: Flexibilidad en acción

                                
                                Punto final compartido
                            
                                GET /api/v1/mensajes
                                Funciona en todos los proveedores
                            
                                Proveedor específico
                            
                                POST /api/v1/linkedin/invitaciones
                                Características exclusivas de LinkedIn
                            
                                Datos brutos
                            
                                GET /api/v1/mensajes?incluir_crudo=true
                                Acceder a la carga útil del proveedor original

Tú eliges el nivel de abstracción.
La API no obliga a hacer concesiones.

Comience con puntos finales unificados sencillos y añada funciones específicas del proveedor según sea necesario.

Construir

Inicio rápido

Empezar a construir en Actas

Elija su idioma, instale el SDK y envíe su primera solicitud de API. Así de sencillo. Documentación completa y ejemplos incluidos.

Node.js / TypeScript

npm install unipile-node-sdk

Python

pip install solicitudes

cURL / REST

Peticiones HTTP directas

Documentación

inicio rápido.js

Obtenga su clave API Leer toda la documentación

6000+ Empresas que innovan con Unipile

La confianza de los líderes del sector

1 API

Racionalizar las operaciones de los principales canales de comunicación

2 días

Rápida integración en directo con una configuración mínima

30%

Reducción de los esfuerzos y recursos de mantenimiento

Seguridad y conformidad integradas

Protección de nivel empresarial para sus datos y flujos de trabajo Más información sobre nuestra seguridad

SOC 2 Tipo II

Certificado

Controles de seguridad auditados de forma independiente que garantizan la protección de datos y la integridad operativa.

GDPR

Conforme

Pleno cumplimiento de la normativa europea de protección de datos para la privacidad de los usuarios.

99.9%

Tiempo de actividad de la plataforma en los últimos 24 meses

24/7

Asistencia global con API de alto rendimiento

PREGUNTAS FRECUENTES SOBRE LA API REST

Preguntas frecuentes sobre la arquitectura REST API unificada de Unipile

01 ¿Qué significa "API REST unificada"?

En lugar de aprender diferentes API para cada proveedor (LinkedIn, WhatsApp, Gmail, etc.), se utiliza un esquema coherente para todos los canales. La misma estructura de solicitud, formato de respuesta y flujo de autenticación funcionan en todas las plataformas, lo que reduce el tiempo de integración de semanas a días.

02 ¿Cuántos puntos finales ofrece la API?

Unipile ofrece ~150 puntos finales unificados que funcionen en todos los proveedores. Sin Unipile, tendría que gestionar más de 500 puntos finales específicos de cada proveedor (cada proveedor tiene su propia estructura de API). Nuestro enfoque unificado significa menos código que escribir, menos casos extremos y un mantenimiento más sencillo. Consulte nuestra referencia completa de la API para más detalles.

03 ¿Cómo funciona la autenticación?

Todas las solicitudes API utilizan Autenticación con token portador. Sólo tiene que incluir su clave API en el campo Authorization de cabeza: Autorización: Portador YOUR_TOKEN. Gestionamos automáticamente los flujos OAuth, la actualización de tokens y las complejidades de autenticación específicas del proveedor.

04 ¿Qué formato de respuesta devuelve la API?

Todas las respuestas están en Formato JSON con una estructura coherente en todos los proveedores. Obtendrá campos normalizados como id, created_at, estadoy provider - no es necesario que normalices tú mismo los datos de distintas fuentes.

05 ¿Existen límites de tarifa para las llamadas a la API?

La propia Unipile ha sin cuotas basadas en el uso ni límites artificiales de tarifas. Sin embargo, los proveedores subyacentes (LinkedIn, WhatsApp, etc.) tienen sus propios límites. Incluimos salvaguardas integradas y gestión de cuotas para ayudarte a mantenerte dentro de las directrices del proveedor y proteger tus cuentas.

06 ¿Cómo puedo recibir actualizaciones en tiempo real?

Utilice nuestro Sistema de webhooks para recibir notificaciones instantáneas. Configure las URL de los webhooks en su panel de control para recibir eventos en tiempo real de nuevos mensajes, cambios de estado, actualizaciones de calendario y mucho más, sin necesidad de sondeos. Los eventos se entregan con el mismo esquema unificado.

07 ¿Cuál es la garantía de tiempo de actividad de la API?

Garantizamos 99,9% de tiempo de actividad SLA para todos los puntos finales de la API. Supervise el estado en tiempo real en estado.unipile.com. Nuestra infraestructura está alojada en Europa, con conmutación automática por error y redundancia integradas.

08 ¿Puedo probar la API antes de comprometerme?

Sí Apúntate a un 7 días de prueba gratuita con acceso completo a la API, sin necesidad de tarjeta de crédito. Pruebe todos los puntos finales, conecte cuentas reales y cree su prueba de concepto. Nuestro documentación y la asistencia en directo le ayudarán a empezar rápidamente.

¿Listo para explorar la API? Empiece a construir hoy mismo.

Ver referencia API