Blog

Um Guia para a API de Publicação da Página da Empresa no LinkedIn

Domine a API de postagem da página da empresa no LinkedIn com nosso guia especializado. Aprenda a automatizar postagens e aumentar sua eficiência de marketing.

Por

Adicione agendamento de redes sociais e análises ao seu aplicativo em minutos com a API do Late.

Experimente o Late gratuitamente.

No seu cerne, o API de publicação para páginas de empresas no LinkedIn é a ponte que permite que seu software se comunique diretamente com o LinkedIn. É a mágica técnica que possibilita que ferramentas de agendamento e plataformas de marketing publiquem conteúdo em uma Página da Empresa automaticamente, sem que ninguém precise fazer login e clicar em "publicar".

Se você já sentiu o peso de gerenciar um calendário de conteúdo, sabe que é um grande desperdício de tempo. Publicar conteúdo manualmente, especialmente se você está lidando com várias contas ou um cronograma de alta demanda, é desgastante. Você está constantemente equilibrando fusos horários, tentando atingir os horários de maior engajamento e lidando com diferentes formatos de conteúdo. Não é apenas tedioso; é uma receita para erros humanos, branding inconsistente e oportunidades perdidas.

É aqui que a API do LinkedIn transforma o jogo. Ao integrá-la ao seu fluxo de trabalho, você pode deixar para trás o ciclo repetitivo de fazer login, fazer upload e publicar. Em vez disso, você pode criar (ou usar) ferramentas que automatizam todo o processo. Isso não é apenas um pequeno ganho de eficiência; é um salto estratégico de postagens reativas e manuais para uma máquina de conteúdo proativa e escalável.

Por que a Automação é Indispensável

Para qualquer equipe de marketing séria hoje em dia, a automação não é apenas um recurso desejável. É uma necessidade fundamental para se manter competitivo e eficaz. A publicação programática através da API é crucial por algumas razões principais:

  • A Consistência Vence: Uma presença constante e confiável mantém sua marca na mente do seu público. A API garante que seu conteúdo seja publicado no horário programado—dia ou noite, durante a semana ou no fim de semana—mantendo esse fluxo crucial de informações.
  • Escale Sem Esforço: Seja você um usuário que publica uma vez por dia ou dez vezes em várias páginas, a API lida com o volume sem esforço. Chega de gargalos.
  • Desbloqueie o Potencial da Sua Equipe: Libere sua equipe de tarefas repetitivas e cansativas. Deixe-os focar no que realmente importa: criar conteúdos incríveis, aprimorar sua estratégia e se engajar de verdade com sua comunidade. Você pode se aprofundar nisso em nosso guia sobre automatizando a publicação em redes sociais.

A partir de 2025, a API de Publicação de Páginas de Empresa do LinkedIn tornou-se fundamental para a forma como empresas inteligentes gerenciam seu marketing. As empresas que utilizam a API não estão apenas agendando publicações; estão gerenciando o engajamento e extraindo análises detalhadas de forma programática. Muitas reduziram seus esforços manuais de distribuição de conteúdo em mais de 70%, um impressionante testemunho de seu poder. Para mais dados sobre o uso da API, confira as informações em socialsurfer.app.

Para ver isso em ação, basta olhar como a própria equipe de engenharia do LinkedIn compartilha atualizações. O feed deles é um exemplo perfeito do conteúdo profissional e consistente que você pode automatizar.

Image

Esse nível de consistência garante que suas valiosas percepções técnicas cheguem de forma confiável ao público certo, construindo autoridade a cada postagem. É um exemplo clássico do porquê a automação é tão poderosa.

Integrar a API do LinkedIn não é apenas uma questão de economizar tempo. É uma estratégia que melhora fundamentalmente a execução da sua estratégia de conteúdo, proporcionando uma vantagem competitiva poderosa.

Por que o seu negócio precisa da API do LinkedIn

Benefício EstratégicoImpacto no Mundo RealExemplo de Aplicação
Consistência InigualávelSua marca mantém uma presença constante e confiável, publicando nos horários ideais para seu público global, mesmo fora do horário comercial.Uma empresa SaaS internacional programa atualizações de produtos para serem publicadas automaticamente às 9h em três fusos horários diferentes (PST, GMT, SGT).
Eficiência OperacionalLibera horas do tempo da sua equipe a cada semana, permitindo que se concentrem em tarefas de alto valor, como criação de conteúdo e análise.Uma agência de marketing automatiza a publicação diária para 20 clientes diferentes, reduzindo o trabalho manual de 15 horas por semana para apenas 2.
Escalabilidade AprimoradaGerencie facilmente um grande volume de conteúdo em várias páginas da empresa sem aumentar a carga de trabalho da sua equipe ou correr o risco de cometer erros.Uma empresa de mídia publica programaticamente mais de 50 artigos e vídeos por dia em suas diversas páginas do LinkedIn.
Insights Baseados em DadosIntegre a publicação com ferramentas de análise para medir o desempenho em tempo real e ajustar automaticamente sua estratégia de conteúdo com base no que está funcionando.O sistema de uma marca de e-commerce identifica quais formatos de postagens geram mais engajamento e prioriza a criação de mais desse tipo de conteúdo.

Ao utilizar a API, você transforma sua estratégia no LinkedIn de uma tarefa manual em uma operação eficiente, baseada em dados e escalável.

Principais Conclusões: Utilizar a API de publicação da página da empresa no LinkedIn transforma sua estratégia de conteúdo de uma tarefa manual em um sistema automatizado e eficiente. Isso permite que você mantenha uma voz de marca consistente, engaje um público global a qualquer hora e libere sua equipe para trabalhos mais estratégicos.

Configurando o Seu Ambiente de Desenvolvimento

Antes de pensar em escrever código, é essencial organizar sua casa dentro do ecossistema de desenvolvedores do LinkedIn. Este é o primeiro obstáculo e, sinceramente, é onde muitos projetos tropeçam logo de início. Estabelecer essa base corretamente vai te poupar uma infinidade de dores de cabeça mais tarde.

Seu ponto de partida é o Portal do Desenvolvedor do LinkedInEste é o seu centro de comando para todas as integrações de API.

Primeiro, você precisa criar um novo aplicativo. Pense neste app como o passaporte digital do seu software—é assim que o LinkedIn sabe quem está fazendo as solicitações. Você preencherá algumas informações básicas, mas a parte mais importante é associá-lo a uma Página de Empresa do LinkedIn. Você precisa vinculá-lo a uma página da qual seja administrador, mesmo que esteja apenas testando.

Assim que seu aplicativo estiver criado, vá diretamente para a aba "Produtos". Este é um passo crucial que muitas vezes é esquecido. Um aplicativo novinho em folha tem quase nenhum poder por padrão. Para desbloquear a capacidade de postar, você deve encontrar e solicitar acesso ao Compartilhar no LinkedIn produto. É isso que ativa o interruptor e lhe dá acesso ao API de publicação para páginas de empresa no LinkedIn.

Garantindo as Permissões Corretas

Com o produto ativado, o próximo passo é solicitar os escopos corretos do OAuth 2.0. Os escopos são uma forma mais elaborada de se referir a "permissões". Eles definem exatamente o que seu aplicativo pode fazer uma vez que o usuário concede acesso.

Para publicar em uma Página da Empresa, o único escopo que você precisa é w_organização_social.

Eu vi muitos desenvolvedores se enrolarem aqui. Eles veem w_member_social e assume que é o correto, mas isso é para publicar em um personal perfil. Se você está direcionando para uma página de empresa, usar o escopo errado é um caminho sem volta para um 403 Proibido erro que vai te fazer arrancar os cabelos.

Para configurar isso, vá até a aba "Auth" do seu aplicativo e adicione w_organização_social à lista de escopos solicitados. Agora, quando um usuário autoriza seu aplicativo, será solicitado explicitamente que ele conceda essa permissão específica.

Configurando suas URLs de Redirecionamento

A última etapa de configuração no Portal do Desenvolvedor é definir suas URLs de Redirecionamento. Estas são simplesmente as URLs que você pré-aprovou para que o LinkedIn envie os usuários de volta após autorizarem seu aplicativo.

Quando o fluxo do OAuth 2.0 é concluído, o LinkedIn redireciona o usuário para um desses URLs com um código de autorização temporário anexado. Seu servidor precisa estar ouvindo nesse endereço. exact URL para capturar o código e prosseguir.

Para testes locais, algo como http://localhost:3000/callback está perfeitamente bem. Mas para uma aplicação ao vivo, deve ser um endpoint HTTPS real e acessível publicamente. Se a sua URL de Redirecionamento estiver ausente ou não corresponder ao que você configurou, todo o processo de autenticação falhará imediatamente.

Dica Profissional: Não posso enfatizar o suficiente—crie uma Página de Empresa no LinkedIn separada e não pública apenas para testes. Isso lhe proporciona um ambiente seguro para explorar a API, testar diferentes formatos de postagem e corrigir erros sem incomodar seus verdadeiros seguidores ou postar acidentalmente um "Olá, Mundo!" na sua página oficial da marca.

Gerenciando Suas Credenciais de Forma Segura

Após toda essa configuração, o LinkedIn irá conceder-lhe um ID do Cliente e um Segredo do Cliente. Trate isso como as chaves do seu reino. O ID do Cliente é público, mas o Segredo do Cliente deve ser protegido com rigor. Nunca, jamais o exponha em código de front-end (como JavaScript no navegador) ou o registre em um repositório Git.

Aqui estão as melhores práticas inegociáveis para gerenciar suas chaves:

  • Armazene-os como variáveis de ambiente no seu servidor.
  • Utilize um serviço dedicado de gestão de segredos como AWS Secrets Manager or HashiCorp Vault.
  • Adote o hábito de rotacionar seu Client Secret periodicamente. Isso minimiza os danos caso ele seja comprometido.

Ao configurar cuidadosamente seu aplicativo, solicitando o essencial w_organização_social definir o escopo e proteger suas credenciais é fundamental para construir uma base sólida para uma integração bem-sucedida. Esse trabalho preparatório elimina os bloqueios de autenticação mais comuns, permitindo que você se concentre no que vem a seguir: construir o fluxo OAuth e fazer sua primeira chamada à API.

Dominando a Autenticação OAuth 2.0

Conectar-se a uma nova API pode às vezes parecer como tentar abrir uma fechadura. A autenticação é sempre a parte mais complicada, e o API de publicação para páginas de empresa no LinkedIn não é diferente. Baseia-se no OAuth 2.0, que é o padrão da indústria por um bom motivo, mas pode parecer um pouco intimidante no início.

Vamos simplificar. O processo é basicamente um aperto de mão em três etapas entre seu aplicativo, o usuário e o LinkedIn.

Imagine que o seu aplicativo é um valet. Ele pede ao usuário as chaves da sua página do LinkedIn. Em vez de entregar a senha real (um grande erro de segurança), o usuário fornece ao seu aplicativo um bilhete temporário—um código de autorização. O seu aplicativo então leva esse bilhete diretamente ao LinkedIn para trocá-lo pelas chaves reais—um token de acesso—que permite que você publique em nome deles.

Isso é conhecido como o fluxo OAuth "três pernas". Ele é projetado para que sua aplicação never não vê nem armazena a senha do LinkedIn do usuário. O que obtém é uma permissão temporária e específica para realizar uma tarefa. É seguro, e é assim que as APIs modernas constroem confiança.

O Fluxo de Código de Autorização

Tudo começa quando um usuário no seu aplicativo clica em um botão como "Conectar LinkedIn." Esse clique aciona um redirecionamento para uma URL de autorização especial que você criou. Você está, essencialmente, enviando o usuário para o LinkedIn com uma nota explicando o que você deseja fazer.

Aqui está o que você precisa para construir essa URL:

  • response_type=codeIsto informa ao LinkedIn que você está iniciando o fluxo de código de autorização.
  • client_idO cartão de identificação público da sua aplicação. Você obtém isso no Portal de Desenvolvedores do LinkedIn.
  • redirect_uriO exact A URL do LinkedIn para a qual o usuário deve ser redirecionado após ter respondido sim ou não. Isso deve corresponder perfeitamente a uma das URLs que você já registrou nas configurações do seu aplicativo.
  • scope: Aqui é onde você declara suas intenções. Para postar em uma página da empresa, você precisa obrigatoriamente organização_social.
  • stateUma string aleatória e única que você gera para este pedido específico. Pense nisso como um aperto de mão secreto. Você verificará isso mais tarde para garantir que não está lidando com um impostor. É uma defesa crítica contra ataques CSRF.

A documentação do LinkedIn possui uma ótima visualização que mapeia toda essa troca.

Image

Como você pode ver, seu aplicativo faz o primeiro movimento, o usuário dá consentimento diretamente no domínio do LinkedIn, e então o LinkedIn os envia de volta para você com o código temporário.

Trocando o Código por um Token de Acesso

Ok, então o usuário aprovou sua solicitação e voltou para o seu redirect_uriA URL agora terá dois parâmetros de consulta importantes: o code e o state valor que você enviou anteriormente.

Primeiro as coisas: verifique o stateSe não corresponder ao que você armazenou para esta sessão, pare tudo. Algo suspeito está acontecendo e você deve rejeitar a solicitação imediatamente.

Se o estado estiver correto, você está na reta final. É hora de trocar aquele temporário. code para um real access_token. Esta parte acontece em segundo plano, como uma chamada direta de servidor para servidor. Você fará um POST solicitação ao endpoint de token do LinkedIn (https://www.linkedin.com/oauth/v2/accessToken). Este pedido precisa incluir o code, seu client_id, seu client_secret (mantenha este seguro!), e o redirect_uri mais uma vez para garantir.

Se tudo correr bem, o LinkedIn irá retornar um objeto JSON. Dentro dele, você encontrará seu prêmio: o access_token. Esta é a chave do reino. Você incluirá este token no Authorization cabeçalho de cada chamada de API que você fizer a partir de agora.

Essa autenticação robusta é o que permite ao LinkedIn proteger seu ecossistema de API, que é construído sobre o poderoso framework Rest.li e atende a mais de 900 milhões de membrosAntes de começar a codificar a lógica de postagem, vale a pena entender melhor práticas gerais de integração com o LinkedIn para ver o quadro geral.

Gerenciando Seus Tokens de Forma Segura

Esse token de acesso é tão sensível quanto o seu client_secret. Trate isso como tal. Armazená-lo em texto simples no seu banco de dados é uma receita para o desastre. Sempre encripte seus tokens em repouso. A segurança não é apenas um recurso; é um requisito fundamental. Se você quiser se aprofundar, preparamos um guia sobre Melhores práticas de segurança para API que aborda isso com mais detalhes.

Além disso, lembre-se de que os tokens de acesso do LinkedIn não duram para sempre. Eles expiram após 60 dias. Seu aplicativo precisa estar preparado para isso. Quando você obtém o token de acesso pela primeira vez, o LinkedIn também envia um refresh_token, que dura um ano inteiro. Você pode usar esse token de atualização para obter um novo token de acesso programaticamente, sem forçar seu usuário a passar por todo o processo de autorização novamente. É essencial para uma experiência do usuário fluida.

Assim que você tiver um token de acesso válido, estará pronto para a parte divertida: publicar conteúdo com o API de publicação para páginas de empresa no LinkedIn. É aqui que você realmente começa a publicar conteúdo ao vivo. O endpoint que você usará para todo o conteúdo orgânico em uma Página da Empresa é /pt/publicações.

Antes de pensar no conteúdo, é fundamental acertar os cabeçalhos. O LinkedIn é rigoroso quanto a isso, e errar pode ser a forma mais rápida de encontrar um erro.

  • Autorização: Bearer {SEU_TOKEN_DE_ACESSO}Este é a sua prova de permissão—o token que você acabou de gerar.
  • Content-Type: application/jsonUm cabeçalho padrão informando à API que você está enviando um payload JSON.
  • LinkedIn-Versão: {YYYYMM}A API do LinkedIn é versionada mensalmente. Você precisa declarar qual versão está utilizando (por exemplo, 202508) para que suas solicitações não quebrem inesperadamente quando houver atualizações.
  • X-Restli-Protocol-Version: 2.0.0Este é um requisito específico para o framework Rest.li do LinkedIn. Não se esqueça disso.

Verifique esses cabeçalhos com atenção toda vez. Um simples erro de digitação aqui pode te levar a um labirinto de depuração, então vale a pena acertá-los desde o início.

Criando uma Publicação de Texto Simples

Vamos começar com uma postagem básica apenas em texto. Pense nisso como o "Olá, Mundo!" da API de Postagens. É a maneira perfeita de garantir que tudo—seu token, cabeçalhos e estrutura de solicitação—está funcionando corretamente antes de você avançar para postagens mais complexas.

O corpo JSON para uma postagem de texto é surpreendentemente enxuto. Você só precisa especificar quem está postando, o que está dizendo e quem pode ver.

A carga útil resume-se a estes campos principais:

  • author: O URN da Página da Empresa para a qual você está publicando (por exemplo, urn:li:organization:1234567).
  • commentaryEste é simplesmente o conteúdo textual da sua publicação.
  • visibilityVocê quase sempre definirá isso como PUBLIC.
  • distributionPara um post padrão que aparece no feed principal, você precisa de um objeto com feedDistribution definir como FEED_PRINCIPAL.
  • lifecycleStateDefina isto para PUBLISHED para que a publicação seja publicada imediatamente.

Aqui está um exemplo de cURL que reúne tudo. Você pode executá-lo diretamente no seu terminal (basta substituir seu token e o URN da sua organização) para testar sua conexão.

curl -X POST 'https://api.linkedin.com/rest/posts'
-H 'Authorization: Bearer {INSERT_TOKEN}'
-H 'X-Restli-Protocol-Version: 2.0.0'
-H 'LinkedIn-Version: 202508'
-H 'Content-Type: application/json'
--data '{
"autor": "urn:li:organization:1234567",
"comentário": "Estamos entusiasmados em compartilhar nossos resultados do Q3! Observamos um crescimento incrível no engajamento dos usuários e lançaremos novas funcionalidades no próximo mês."
"visibilidade": "PÚBLICA",
"distribuição": {
"feedDistribution": "FEED_PRINCIPAL"
},
"lifecycleState": "PUBLICADO"
}'
Se tudo estiver correto, você receberá um 201 Criado código de status de volta. A resposta também incluirá um x-restli-id cabeçalho contendo o URN da sua nova publicação. Guarde isso—é útil caso você precise referenciar ou excluir a publicação mais tarde.

Publicando Publicações com Mídia

O texto é bom, mas sejamos honestos, os visuais são o que realmente chamam a atenção. Publicar com uma imagem ou vídeo não é tão simples quanto apenas adicionar uma URL ao seu payload. É um processo em várias etapas, mas lógico uma vez que você compreende o fluxo. Você precisa fazer o upload do seu conteúdo nos servidores do LinkedIn. first.

Este diagrama apresenta os três principais passos para adicionar mídia às suas publicações.

Image

Como você pode ver, o upload da mídia é uma etapa preliminar e separada. Você prepara tudo do lado do LinkedIn. before você cria a publicação que a utiliza.

Aqui está como isso se divide:

  1. Registre o Upload: Você acessou um endpoint específico de mídia (como /pt/imagens) para informar ao LinkedIn: "Oi, estou prestes a fazer um upload." O LinkedIn responde com duas informações cruciais: um URN de mídia único (por exemplo, urn:li:image:{id}) e uma URL de upload temporária e única.

  2. Carregar a MídiaCom esse URL especial em mãos, você envia um PUT or POST faça a solicitação diretamente para ele, com seu arquivo de imagem ou vídeo bruto como corpo. Isso envia o arquivo para o armazenamento do LinkedIn.

  3. Crie a PublicaçãoAgora você está de volta ao /pt/publicações endpoint. Você constrói uma solicitação assim como a postagem de texto, mas desta vez, você inclui um content objeto que aponta para o URN da mídia da etapa um.

Pode parecer um pouco complicado, mas isso torna o sistema mais confiável ao separar o upload de arquivos, que pode ser mais lento, da criação rápida dos metadados da publicação em si.

Insight Principal: Você deve fazer o upload da sua mídia. before criando a publicação. A chamada final da API para /pt/publicações simplesmente anexa a mídia já carregada ao comentário. Este é um ponto comum de confusão para desenvolvedores que estão começando a trabalhar com a API do LinkedIn.

Vamos ver um exemplo em Python para postar uma imagem. Note que a content o bloco é a única grande adição em comparação com a versão apenas de texto.

import requests
import json

access_token = "YOUR_ACCESS_TOKEN"
organization_urn = "urn:li:organization:1234567"
image_urn = "urn:li:image:C5E10AQF-g_6y2b5rQ" # URN da etapa de upload

url = "https://api.linkedin.com/rest/posts"

headers = {
"Authorization": f"Bearer {access_token}",
"Content-Type": "application/json",
"LinkedIn-Version": "202508",
"X-Restli-Protocol-Version": "2.0.0"
}

payload = {
"autor": organization_urn,
"comentário": "Confira nossa equipe na conferência anual de tecnologia! #VidaTech #Inovação"
"visibilidade": "PÚBLICA",
"distribuição": {
"feedDistribution": "FEED_PRINCIPAL"
},
"conteúdo": {
"mídia": {
"id": image_urn
}
},
"lifecycleState": "PUBLICADO"
}

response = requests.post(url, headers=headers, data=json.dumps(payload))

se response.status_code == 201:
post_urn = response.headers.get("x-restli-id")
print(f"Postagem realizada com sucesso! URN da postagem: {post_urn}")
else:
print(f"Erro: {response.status_code}")
print(response.json())
Você deve seguir exatamente o mesmo padrão para vídeos ou documentos—basta garantir que está utilizando o tipo de URN correto que recebeu durante a etapa de registro.

Gerenciar esses diferentes fluxos para cada plataforma social é exatamente o motivo pelo qual muitos desenvolvedores recorrem a uma API unificada de publicação em redes sociais. Ele abstrai essas peculiaridades específicas de cada plataforma. Mas ao dominar esse fluxo de publicação essencial, você desbloqueou o recurso mais poderoso do API de publicação para páginas de empresa no LinkedIn e agora pode criar uma automação de conteúdo realmente impressionante.

Resolvendo Erros Comuns de API

Image

Vamos ser sinceros—mesmo com uma configuração perfeita, você vai enfrentar erros ao trabalhar com o API de publicação para páginas de empresa no LinkedInÉ apenas parte do processo. O segredo é ver os erros da API não como falhas, mas como indicadores que mostram exatamente o que precisa ser corrigido. Aprender a interpretar esses sinais é o que distingue uma integração frágil de uma robusta.

Quando uma chamada de API falha, sua primeira pista é o código de status HTTP. Esses números de três dígitos são a linguagem universal dos erros na web, e você vai se familiarizar com alguns deles rapidamente.

Decodificando Códigos de Status Comuns

Considere esses códigos como sua primeira linha de diagnóstico. Em vez de adivinhar o que deu errado, você pode usar o código para identificar o problema e ir direto à solução.

  • 401 Não Autorizado: Este é um assunto que trata da autenticação. É a forma que a API tem de dizer: "Não sei quem você é." Isso significa que seu token de acesso está ausente, expirado ou simplesmente incorreto. Sua primeira ação deve ser sempre gerar um novo token e verificar se ele está sendo passado corretamente no Autorização: Bearer {token} cabeçalho. Lembre-se de que os tokens expiram a cada 60 dias, então seu aplicativo precisa de uma maneira confiável de atualizá-los.

  • 403 ProibidoEste erro é um pouco diferente; trata-se de permissionsA API sabe quem você é, mas você não tem permissão para o que está tentando fazer. Com a API de Posts, isso quase sempre indica uma das duas coisas: o usuário que autorizou o aplicativo não é um Super Administrador or Administrador de Conteúdo da Página da Empresa, ou seu aplicativo está faltando o crítico w_organização_social escopo.

  • 400 Solicitação Inválida: Este é um aviso geral para quando a solicitação em si está com falhas. Na maioria das vezes, o culpado é um payload JSON malformado. Uma vírgula fora do lugar, um campo obrigatório ausente como authorou enviar um número onde se espera uma string pode acionar um 400. Sempre valide a estrutura do seu JSON com a documentação do LinkedIn antes de enviar a solicitação.

Ponto Principal: A 401 sua chave está inválida. A 403 significa que sua chave está boa, mas você não pode abrir essa porta. A 400 significa que você está falando uma linguagem que a API não entende.

Respeitando os Limites de Taxa da API

À medida que sua aplicação cresce, você inevitavelmente encontrará os 429 Muitas Solicitações erro. O LinkedIn, assim como todas as outras grandes plataformas, utiliza limites de taxa para manter seu serviço estável e justo para todos. Atingir esse limite significa apenas que você fez muitas chamadas à API em um curto espaço de tempo.

Ignorar os limites de taxa é uma receita para o desastre. A abordagem profissional é lidar com eles de forma adequada. Felizmente, o LinkedIn oferece as ferramentas necessárias para isso nos cabeçalhos de resposta de cada chamada de API. Procure por X-LI-Limite-de-Ritmo-Limite (o total que você tem permitido) e X-LI-Limite-de-Rate-Restante (se quantos você ainda tem). Seu código deve monitorar esses cabeçalhos para saber quando desacelerar.

Quando você é atingido por um 429, a pior coisa que você pode fazer é tentar novamente imediatamente. Essa é uma maneira rápida de ficar preso em um ciclo de falhas. A melhor prática é implementar um retrocesso exponencial estratégia. Isso significa que, se uma solicitação falhar, você espera um segundo antes de tentar novamente. Se falhar novamente, espere dois segundos, depois quatro, e assim por diante.

Esta técnica simples dá tempo ao API para redefinir seu limite e impede que seu aplicativo sobrecarregue os servidores. Aqui está um resumo rápido do porquê é a melhor escolha:

StrategyDescriptionOutcome
Tentativa ImediataO aplicativo tenta novamente a solicitação falhada instantaneamente.Frequentemente leva a repetições 429 erros e pode fazer com que seu aplicativo seja temporariamente bloqueado.
Atraso FixoA aplicação aguarda um tempo constante (por exemplo, 5 segundos) antes de cada nova tentativa.Melhor, mas pode ser ineficiente se o limite se redefinir rapidamente ou muito lento se não o fizer.
Retrocesso ExponencialO tempo de espera para nova tentativa dobra a cada falha subsequente.O método mais eficaz e recomendado para lidar com limites de taxa de forma suave.

Ao implementar um tratamento inteligente de erros e respeitar os limites de taxa desde o início, você não está apenas criando um aplicativo que funciona—você está desenvolvendo um que é resiliente e profissional.

Perguntas Frequentes e Obstáculos

Quando você está imerso no código, algumas perguntas comuns e casos extremos sempre surgem, especialmente com uma API tão específica quanto a do LinkedIn. Já enfrentei minha cota desses problemas, então aqui estão algumas respostas rápidas para as questões que costumam pegar os desenvolvedores de surpresa.

Posso mencionar utilizadores ou empresas em um post da API?

Sim, você pode e deve—é uma ótima maneira de aumentar o engajamento. Mas não adianta simplesmente colocar um símbolo "@" no seu texto e esperar o melhor. O LinkedIn exige que você utilize o formato URN (Nome de Recurso Uniforme) específico deles diretamente dentro do commentary campo.

Parece algo assim:

  • Mencionando uma pessoa:@Nome do Membro
  • Mencionando uma empresa:@Nome da Empresa

O verdadeiro truque é encontrar esse URN. Você precisará construir uma chamada de API separada em seu fluxo de trabalho—geralmente para um endpoint de busca ou consulta—para obter o ID da pessoa ou empresa que deseja marcar. Isso adiciona uma etapa extra, mas é a única maneira de fazer menções funcionarem de forma programática.

Como faço para publicar em uma Página de Destaque do LinkedIn?

Boas notícias! Publicar em uma Página de Exibição é quase exatamente igual a publicar em uma Página de Empresa comum. O processo é idêntico, com apenas uma pequena mudança: a author URN.

Em vez do URN principal da sua empresa, você só precisa substituir pelo URN único daquela Página de Showcase específica. A maneira mais fácil que encontrei para obter esses URNs é acessando um endpoint como /organizationalEntityAcls. Ele fornece uma lista clara de todas as páginas e organizações às quais você tem acesso de administrador, completa com seus URNs.

O que causa um erro 403 Proibido?

Ah, o temido 403 Proibido erro. É frustrante, mas quase sempre que vejo isso, tudo se resume a um simples problema de permissões. A API sabe quem você é, mas decidiu que você não tem a autorização necessária para o que está tentando fazer.

Antes de começar a desmontar seu código, verifique primeiro estas três coisas:

  1. Escopos Incorretos: Parece que você esqueceu de solicitar o w_organização_social escopo durante o fluxo OAuth 2.0? É essencial.
  2. Função de Utilizador Incorreta: A pessoa que autorizou o aplicativo deve ser um Super Administrador or Administrador de Conteúdo da página da empresa. Sem exceções.
  3. Token incompatível: Talvez o seu aplicativo esteja configurado corretamente, mas o token de acesso específico que você está usando foi gerado without esse escopo necessário.

Nove vezes em dez, um desses é o culpado. Verifique novamente as permissões do seu aplicativo, o papel do usuário na página e os escopos associados ao seu token, e você provavelmente resolverá o problema.

Insight Principal: Lembre-se, um 403 não é uma falha de autenticação (isso é um 401). É um authorization falha. Sua chave funciona, mas você está tentando abrir uma porta para a qual não tem permissão.

A API do LinkedIn suporta agendamento de publicações?

Não, não nativamente. A API do LinkedIn não possui uma funcionalidade de agendamento integrada. /Posts o endpoint é para gratificação instantânea—quando você envia uma solicitação bem-sucedida com lifecycleState definir para PUBLISHEDseu conteúdo é publicado imediatamente.

Se precisar agendar publicações, terá que construir essa lógica você mesmo. É uma tarefa clássica para desenvolvedores, e uma abordagem comum é configurar um sistema simples do seu lado:

  • Armazene o conteúdo da postagem, o URN da página-alvo e o horário de publicação desejado em um banco de dados.
  • Execute um cron job ou uma tarefa agendada no seu servidor que verifique o banco de dados a cada minuto.
  • Quando a tarefa encontra uma publicação que está programada, ela dispara a chamada da API para o LinkedIn.

Isso lhe dá controle total sobre sua programação de publicações, enquanto ainda aproveita a poderosa API do LinkedIn para a entrega real.


Cansado de criar lógicas de agendamento personalizadas e lidar com as diferentes regras de API para cada plataforma social? LATE oferece uma API unificada para publicação em redes sociais que permite publicar no LinkedIn, Instagram, TikTok e em outras quatro plataformas com uma única integração simplificada. Configure em minutos e concentre-se em desenvolver funcionalidades, não em manter conexões. Comece a automatizar gratuitamente em https://getlate.dev.

Incorpore a automação de redes sociais ao seu produto.

Adicione agendamento de redes sociais e análises ao seu aplicativo em minutos com a API do Late.

Criado para desenvolvedores. Adorado por agências. Confiado por 6.325 usuários.