Arquitetura da API REST

Um API REST unificada para todos os canais

Pare de fazer malabarismos com várias implementações de API. O Unipile oferece um esquema de API REST único e consistente que funciona no LinkedIn, WhatsApp, Gmail, Outlook e em todas as principais plataformas de comunicação. Escreva uma vez, integre em qualquer lugar.

Crie já Referência da API

unified-api.js

// Uma estrutura de solicitação para todos os provedores

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!"

})

});

// A mesma estrutura funciona para:

// LinkedIn - WhatsApp - Gmail - Instagram - Telegram

200 OK - Mensagem enviada

Por que o Unified é importante

O poder de um Esquema unificado

Veja a diferença entre manter várias integrações de API e usar um esquema unificado. Menos código, menos bugs, desenvolvimento mais rápido.

APIs nativas Complexo

linkedin-message.js

                            const linkedin = require('linkedin-api-client');
                            await linkedin.messages.create({
                              recipients: ['urn:li:person: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({ versão: 'v1', auth });
                            const bruto = Buffer.from(
                              `To: ${to}\r\nSubject: ${subject}\r\n\r\n${body}`
                            ).toString('base64');
                            await gmail.users.messages.send({
                              userId: "eu, requestBody: { raw }
                            });
                        

Com a Unipile Recomendado

send-message.js

Todos os provedores

                            // Uma função para TODAS as plataformas de mensagens
                            async function sendMessage(accountId, recipient, text) {
                              return fetch(`https://api.unipile.com/api/v1/messages`, {
                                method: 'POST',
                                headers: {
                                  'Authorization': `Bearer ${API_KEY}`,
                                  'Content-Type': 'application/json'
                                },
                                body: JSON.stringify({
                                  account_id: accountId,
                                  attendees: [{ identifier: recipient }],
                                  text: text
                                })
                              });
                            }
                            // Funciona para: LinkedIn, WhatsApp, Gmail, Instagram...
                        

APIs nativas

SDK diferente para cada plataforma

Formatos de dados e respostas inconsistentes

Fluxos de autenticação separados para gerenciar

3x mais código para escrever e manter

Com a Unipile

Base de código única para todos os provedores

Tratamento de erros e respostas unificados

Adicionar novos canais sem alterações no código

90% menos código para manter

90%

Menos código para escrever
e manter

1 semana

Tempo médio de integração
vs. meses com APIs nativas

0

Mudanças significativas
ao adicionar novos provedores

Comece a criar com a API unificada

Tudo o que você precisa, Uma API

De mensagens a calendários, acesse todos os recursos de comunicação por meio de endpoints REST consistentes e bem documentados. Mesma estrutura, mesmas respostas, em todos os provedores.

Mensagens

Envie, receba e gerencie mensagens no LinkedIn, WhatsApp, Instagram e Telegram.

OBTER POST PUT DELETE

/api/v1/messages

/api/v1/chats/{chat_id}

Email

Gerenciamento completo de e-mails com Gmail, Outlook e IMAP. Envie, leia, organize e rastreie e-mails.

OBTER POST PUT DELETE

/api/v1/emails

/api/v1/emails/{email_id}

Calendário

Gerencie eventos, programações e disponibilidade no Google Calendar e no Outlook Calendar.

OBTER POST PUT DELETE

/api/v1/calendar/events

/api/v1/calendar/availability

Perfis

Acesse informações de contato, perfis do LinkedIn, dados da empresa e insights sobre relacionamentos.

OBTER POST

/api/v1/users/{identifier}

/api/v1/companies/{id}

Publicações

Criar e gerenciar postagens no LinkedIn e no Instagram. Lidar com comentários, reações e engajamento.

OBTER POST DELETE

/api/v1/posts/{post_id}

/api/v1/posts/{post_id}/comments

Administrador

Gerencie contas e webhooks de forma programática. Lidar com conexões, autenticação e eventos.

Referência da API do Explore

Criado para Desenvolvedores

Uma API pronta para produção com confiabilidade empresarial. Envie mais rapidamente, faça menos manutenção e dimensione com confiança.

Economize semanas de desenvolvimento

Pare de criar infraestrutura. Concentre-se em seu produto enquanto nós cuidamos da complexidade.

Sem Unipile

Criar fluxos de autenticação por provedor

Atualizar cada integração

Lidar com mudanças significativas na API

Gerencie você mesmo os limites de tarifas

Com a Unipile

Autenticação hospedada pronta para uso

Sem ônus de manutenção

Cuidamos de todas as atualizações

Manuseio inteligente do limite de taxa

Acesso direto à API, sem raspagem

Conexões de API com todos os provedores. Respostas mais rápidas, maior confiabilidade, sem risco de bloqueio.

Design RESTful limpo

Endpoints intuitivos que seguem as práticas recomendadas de REST. URLs baseados em recursos, métodos HTTP padrão, códigos de status adequados.

Manuseio inteligente de limite de taxa

Gerenciamento automático do limite de taxa em todos os provedores. Nós enfileiramos, tentamos novamente e otimizamos as solicitações para que você não precise fazer isso.

Documentação abrangente

Guias detalhados, exemplos de código e referências de API para cada endpoint. Comece a usar em minutos, não em dias.

Explorador interativo de API

Copiar e colar trechos de código

Tutoriais passo a passo

Alto desempenho

Tempos de resposta extremamente rápidos com confiabilidade comprovada. Desenvolvido em uma infraestrutura global para velocidade em qualquer lugar.

Latência ultrabaixa

99,9% de tempo de atividade em 24 meses

Distribuição global de CDN

Segurança empresarial

Criptografia em nível de banco, OAuth 2.0 e conformidade com SOC 2. Seus dados e os dados de seus usuários permanecem protegidos.

Compatível com o GDPR

Compatível com SOC 2

Gerenciamento seguro de tokens

Abstração do provedor sem perda de recursos

A maioria das camadas de agregação achata os recursos. O Unipile não faz isso. A API REST foi projetada para expor recursos específicos do provedor quando necessário, manter a consistência dos pontos de extremidade comuns e permitir a adoção progressiva de recursos avançados.

Pontos de extremidade compartilhados para operações comuns

Uma visualização básica da caixa de entrada usa endpoints compartilhados em todos os provedores para um comportamento consistente.

Rotas específicas do provedor para recursos avançados

As ações avançadas do LinkedIn estão disponíveis por meio de rotas dedicadas quando você precisar delas.

Dados brutos do provedor quando necessário

O acesso aos dados brutos do provedor está sempre disponível quando você precisa de controle total ou de metadados específicos.

Exemplo: Flexibilidade em ação

                                
                                Ponto de extremidade compartilhado
                            
                                OBTER /api/v1/messages
                                Funciona em todas as operadoras
                            
                                Específico do provedor
                            
                                POST /api/v1/linkedin/convites
                                Recursos exclusivos do LinkedIn
                            
                                Dados brutos
                            
                                OBTER /api/v1/mensagens?incluir_cru=verdadeiro
                                Acesso à carga útil original do provedor #

Você escolhe o nível de abstração.
A API não obriga a fazer concessões.

Comece com endpoints unificados simples e adicione recursos específicos do provedor conforme necessário.

Crie já

Início rápido

Comece a construir em Minutos

Escolha seu idioma, instale o SDK e envie sua primeira solicitação de API. É simples assim. Documentação completa e exemplos incluídos.

Node.js / TypeScript

npm install unipile-node-sdk

Python

pip install requests

cURL / REST

Solicitações HTTP diretas

Documentação

quick-start.js

Obter sua chave de API Leia a documentação completa

6000+ Empresas que inovam com a Unipile

Com a confiança dos líderes do setor

1 API

Simplificar as operações de todos os principais canais de comunicação

2 dias

Obtenha integração ao vivo rapidamente com o mínimo de configuração

30%

Redução dos esforços e recursos de manutenção

Segurança e conformidade incorporadas

Proteção de nível empresarial para seus dados e fluxos de trabalho Saiba mais sobre nossa segurança

SOC 2 Tipo II

Certificado

Controles de segurança auditados de forma independente, garantindo a proteção dos dados e a integridade operacional.

GDPR

Em conformidade

Conformidade total com os regulamentos europeus de proteção de dados para a privacidade do usuário.

99.9%

Tempo de atividade da plataforma nos últimos 24 meses

24/7

Suporte global com API de alto desempenho

PERGUNTAS FREQUENTES SOBRE A API REST

Perguntas comuns sobre a arquitetura da API REST unificada da Unipile

01 O que significa "API REST unificada"?

Em vez de aprender APIs diferentes para cada provedor (LinkedIn, WhatsApp, Gmail, etc.), você usa um esquema consistente para todos os canais. A mesma estrutura de solicitação, o mesmo formato de resposta e o mesmo fluxo de autenticação funcionam em todas as plataformas, reduzindo o tempo de integração de semanas para dias.

02 Quantos pontos de extremidade a API oferece?

A Unipile fornece ~150 pontos de extremidade unificados que funcionam em todos os provedores. Sem o Unipile, você precisaria gerenciar mais de 500 pontos de extremidade específicos de cada provedor (cada provedor tem sua própria estrutura de API). Nossa abordagem unificada significa menos código para escrever, menos casos extremos e manutenção mais simples. Confira nossa Referência completa da API para obter detalhes.

03 Como funciona a autenticação?

Todas as solicitações de API usam Autenticação de token de portador. Basta incluir sua chave de API no campo Authorization cabeçalho: Autorização: Portador YOUR_TOKEN. Lidamos automaticamente com fluxos OAuth, atualização de tokens e complexidades de autenticação específicas do provedor.

04 Qual é o formato de resposta que a API retorna?

Todas as respostas estão em Formato JSON com estrutura consistente em todos os provedores. Você obtém campos padronizados como id, created_at, statuse provider - não há necessidade de normalizar dados de diferentes fontes por conta própria.

05 Há limites de taxa nas chamadas de API?

A própria Unipile tem sem taxas baseadas no uso ou limites artificiais de tarifas. No entanto, os provedores subjacentes (LinkedIn, WhatsApp, etc.) têm seus próprios limites. Incluímos proteções integradas e gerenciamento de cotas para ajudá-lo a permanecer dentro das diretrizes do provedor e proteger suas contas.

06 Como faço para receber atualizações em tempo real?

Use nosso Sistema de webhooks para receber notificações instantâneas. Configure URLs de webhook em seu painel para obter eventos em tempo real de novas mensagens, alterações de status, atualizações de calendário e muito mais, sem necessidade de pesquisa. Os eventos são fornecidos com o mesmo esquema unificado.

07 Qual é a garantia de tempo de atividade da API?

Nós garantimos SLA de tempo de atividade de 99,9% para todos os pontos de extremidade da API. Monitore o status em tempo real em status.unipile.com. Nossa infraestrutura é hospedada na Europa, com failover e redundância automáticos integrados.

08 Posso testar a API antes de me comprometer?

Sim! Registre-se para um Teste gratuito de 7 dias com acesso total à API, sem necessidade de cartão de crédito. Teste todos os pontos de extremidade, conecte contas reais e crie sua prova de conceito. Nossos documentação e o suporte ao vivo ajudam você a começar rapidamente.

Pronto para explorar a API? Comece a criar hoje mesmo.

Exibir referência da API