En su esencia, laAPI para publicar en páginas de empresa de LinkedInes el puente que permite que tu software se comunique directamente con LinkedIn. Es la magia técnica que permite a las herramientas de programación y plataformas de marketing publicar contenido en una Página de Empresa de forma automática, sin que nadie tenga que iniciar sesión y hacer clic en "publicar".
Si alguna vez has sentido la presión de gestionar un calendario de contenido, sabes que es una gran pérdida de tiempo. Publicar contenido manualmente, especialmente si manejas múltiples cuentas o un calendario de alta carga, es brutal. Estás constantemente lidiando con zonas horarias, tratando de alcanzar las horas de mayor engagement y luchando con diferentes formatos de contenido. No solo es tedioso; es una receta para errores humanos, branding inconsistente y oportunidades que se escapan.
Aquí es donde la API de LinkedIn transforma las reglas del juego. Al integrarla en tu flujo de trabajo, puedes dejar atrás el ciclo repetitivo de iniciar sesión, subir y publicar. En su lugar, puedes crear (o utilizar) herramientas que automaticen todo el proceso. Esto no es solo una pequeña mejora en la eficiencia; es un salto estratégico de la publicación manual y reactiva a una máquina de contenido proactiva y escalable.
Por qué la automatización es indispensable
Para cualquier equipo de marketing serio hoy en día, la automatización no es solo un lujo. Es un requisito fundamental para mantenerse competitivo y efectivo. La publicación programática a través de la API es crucial por varias razones clave:
- La Consistencia Gana:Una presencia constante y confiable mantiene tu marca en la mente de tu audiencia. La API garantiza que tu contenido se publique según lo programado—día o noche, entre semana o fin de semana—manteniendo ese flujo crucial de información.
- Escala Sin Esfuerzo:Ya sea que publiques una vez al día o diez veces en múltiples páginas, la API maneja el volumen sin esfuerzo. No más cuellos de botella.
- Desbloquea el Potencial de Tu Equipo:Libera a tu equipo de tareas repetitivas y aburridas. Permíteles concentrarse en lo que realmente importa: crear contenido impactante, perfeccionar tu estrategia y conectar de verdad con tu comunidad. Puedes profundizar en esto en nuestra guía sobreautomatización de publicaciones en redes sociales.
Como de2025, la API de Publicación de Páginas de Empresa de LinkedIn se ha vuelto fundamental para la forma en que las empresas inteligentes gestionan su marketing. Las empresas que utilizan la API no solo están programando publicaciones; están gestionando la interacción y obteniendo análisis detallados de manera programática. Muchas han reducido sus esfuerzos de distribución de contenido manual en más de70%, un asombroso testimonio de su poder. Para obtener más datos sobre el uso de la API, consulta las estadísticas ensocialsurfer.app.
Para ver esto en acción, solo tienes que observar cómo el equipo de ingeniería de LinkedIn comparte actualizaciones. Su feed es un ejemplo perfecto del contenido profesional y consistente que puedes automatizar.
Este nivel de consistencia garantiza que sus valiosos conocimientos técnicos lleguen de manera confiable al público adecuado, construyendo autoridad con cada publicación. Es un caso de estudio perfecto de por qué la automatización es tan poderosa.
Integrar la API de LinkedIn no se trata solo de ahorrar tiempo. Es un movimiento estratégico que mejora fundamentalmente la forma en que ejecutas tu estrategia de contenido, brindándote una poderosa ventaja competitiva.
Por qué tu negocio necesita la API de LinkedIn
Beneficio Estratégico | Impacto en el Mundo Real | Aplicación de Ejemplo |
---|---|---|
Consistencia Inigualable | Tu marca mantiene una presencia constante y confiable, publicando en los momentos óptimos para tu audiencia global, incluso fuera del horario laboral. | Una empresa SaaS internacional programa actualizaciones de productos para publicarse automáticamente a las 9 AM en tres zonas horarias diferentes (PST, GMT, SGT). |
Eficiencia Operativa | Libera horas del tiempo de tu equipo cada semana, permitiéndoles concentrarse en tareas de alto valor como la creación de contenido y el análisis. | Una agencia de marketing automatiza la publicación diaria para 20 clientes diferentes, reduciendo el trabajo manual de 15 horas a la semana a solo 2. |
Escalabilidad Mejorada | Gestiona fácilmente un alto volumen de contenido en múltiples páginas de la empresa sin aumentar la carga de trabajo de tu equipo ni arriesgarte a cometer errores. | Una empresa de medios publica programáticamente más de 50 artículos y videos al día en sus diversas páginas de LinkedIn. |
Perspectivas Basadas en Datos | Integra la publicación con herramientas de análisis para medir el rendimiento en tiempo real y ajustar automáticamente tu estrategia de contenido según lo que esté funcionando. | El sistema de una marca de comercio electrónico registra qué formatos de publicaciones generan más interacción y prioriza la creación de más contenido de ese tipo. |
Al aprovechar la API, transformas tu estrategia de LinkedIn de una tarea manual en una operación eficiente, basada en datos y escalable.
Conclusión clave:Utilizar la API de publicación de páginas de empresa de LinkedIn transforma tu estrategia de contenido de una tarea manual en un sistema eficiente y automatizado. Te permite mantener una voz de marca coherente, involucrar a una audiencia global las 24 horas del día y liberar a tu equipo para que se enfoque en trabajos más estratégicos.
Configurando tu Entorno de Desarrollo
Antes de que puedas siquiera pensar en escribir código, necesitas poner en orden tu casa dentro del ecosistema de desarrolladores de LinkedIn. Este es el primer obstáculo y, francamente, es donde muchos proyectos tropiezan desde el principio. Establecer bien esta base te ahorrará un mundo de dolores de cabeza más adelante.
Tu punto de partida es elPortal de Desarrolladores de LinkedInEste es tu centro de mando para todas las integraciones de API.
Primero lo primero, necesitas crear una nueva aplicación. Piensa en esta app como el pasaporte digital de tu software: es la forma en que LinkedIn sabe quién está haciendo las solicitudes. Completarás algunos datos básicos, pero la parte más importante es asociarla con una Página de Empresa de LinkedIn. Debes vincularla obligatoriamente a una página de la que seas administrador, incluso si solo estás probando.
Una vez que tu aplicación esté creada, dirígete directamente a la pestaña de "Productos". Este es un paso crucial que a menudo se pasa por alto. Una aplicación nueva casi no tiene poder por defecto. Para desbloquear la capacidad de publicar, debes encontrar y solicitar acceso a laCompartir en LinkedInproducto. Esto es lo que activa el interruptor y te brinda acceso a laAPI para publicar en páginas de empresa de LinkedIn.
Asegurando los permisos adecuados
Con el producto habilitado, la siguiente pieza del rompecabezas es solicitar los scopes correctos de OAuth 2.0. Los scopes son simplemente una forma elegante de decir "permisos". Definen exactamente lo que tu aplicación puede hacer una vez que un usuario le concede acceso.
Para publicar en una Página de Empresa, el único alcance que necesitas esw_organización_social
.
He visto a muchos desarrolladores tropezar aquí. Ellos venw_member_social
y asumir que es el correcto, pero eso es para publicar en unpersonalperfil. Si estás dirigiéndote a una página de empresa, usar el alcance incorrecto es un billete de ida a un403 Prohibido
error that will have you pulling your hair out.
Para configurar esto, ve a la pestaña "Auth" de tu aplicación y añadew_organización_social
a la lista de ámbitos solicitados. Ahora, cuando un usuario autorice tu aplicación, se le pedirá explícitamente que conceda este permiso específico.
Configurando tus URLs de redirección
La última parte de la configuración en el Portal de Desarrolladores es establecer tus URLs de Redirección. Estas son simplemente las URLs que has preaprobado para que LinkedIn envíe a los usuarios de vuelta después de que hayan autorizado tu aplicación.
Cuando el flujo de OAuth 2.0 se completa, LinkedIn redirige al usuario a una de estas URL con un código de autorización temporal adjunto. Tu servidor debe estar escuchando en esa dirección.exactURL para capturar el código y continuar.
Para pruebas locales, algo comohttp://localhost:3000/callback
está perfectamente bien. Pero para una aplicación en vivo, debe ser un endpoint HTTPS real y accesible públicamente. Si tu URL de redirección falta o no coincide con lo que has configurado, todo el proceso de autenticación fallará de inmediato.
Consejo Profesional:No puedo enfatizar esto lo suficiente: crea una página de empresa en LinkedIn separada y no pública solo para pruebas. Esto te proporciona un entorno seguro para experimentar con la API, probar diferentes formatos de publicaciones y depurar errores sin inundar a tus verdaderos seguidores o publicar accidentalmente un "¡Hola, mundo!" en la página oficial de tu marca.
Gestionando tus credenciales de manera segura
Después de toda esa configuración, LinkedIn te otorgará unID de clienteLo siento, parece que tu mensaje está incompleto. ¿Podrías proporcionar más contexto o el texto que deseas traducir?Secreto del Cliente. Trata estos como las llaves de tu reino. El ID del cliente es público, pero elSecreto del Clientedebe ser protegido con firmeza. Nunca, bajo ninguna circunstancia, lo expongas en código del lado del cliente (como JavaScript en el navegador) ni lo subas a un repositorio de Git.
Aquí están las mejores prácticas innegociables para manejar tus claves:
- Almacénalos como variables de entorno en tu servidor.
- Utiliza un servicio dedicado de gestión de secretos comoAWS Secrets Manager or HashiCorp Vault.
- Hazte el hábito de rotar tu Clave Secreta del Cliente periódicamente. Esto minimiza el daño en caso de que alguna vez se vea comprometida.
Al configurar cuidadosamente tu aplicación y solicitar el crucialw_organización_social
Al definir el alcance y asegurar tus credenciales, estás construyendo la base sólida necesaria para una integración exitosa. Este trabajo de preparación elimina los obstáculos de autenticación más comunes, permitiéndote concentrarte en lo que sigue: construir el flujo de OAuth y realizar tu primera llamada a la API.
Dominando la autenticación OAuth 2.0
Conectarse a una nueva API a veces puede sentirse como intentar abrir una cerradura. La autenticación siempre es la parte más complicada, y elAPI de publicación para páginas de empresa en LinkedInno es diferente. Se basa en OAuth 2.0, que es el estándar de la industria por una buena razón, pero puede parecer un poco intimidante al principio.
Desglosemos el proceso. Básicamente, se trata de un apretón de manos en tres pasos entre tu aplicación, el usuario y LinkedIn.
Imagina que tu aplicación es un valet. Le pide al usuario las llaves de su página de LinkedIn. En lugar de entregar su contraseña real (un gran error de seguridad), el usuario le da a tu aplicación un ticket temporal: un código de autorización. Tu aplicación luego lleva ese ticket directamente a LinkedIn para intercambiarlo por las llaves reales: un token de acceso que le permite publicar en su nombre.
Esto es lo que se conoce como el flujo OAuth de "tres patas". Está diseñado para que tu aplicaciónneverve o almacena la contraseña de LinkedIn del usuario. Solo obtiene un permiso temporal y específico para realizar una tarea. Es seguro, y así es como las APIs modernas construyen confianza.
El flujo de código de autorización
Todo comienza cuando un usuario en tu aplicación hace clic en un botón como "Conectar LinkedIn". Este clic activa una redirección a una URL de autorización especial que has creado. Esencialmente, estás enviando al usuario a LinkedIn con una nota que explica lo que deseas hacer.
Aquí tienes lo que necesitas para construir esa URL:
tipo_de_respuesta=código
Esto le indica a LinkedIn que estás iniciando el flujo de código de autorización.id_cliente
La tarjeta de identificación pública de tu aplicación. Obtén esto desde el Portal de Desarrolladores de LinkedIn.redirect_uri
Lo siento, parece que no has proporcionado el texto que deseas traducir. Por favor, envíamelo y estaré encantado de ayudarte.exactLa URL de LinkedIn a la que el usuario debe regresar después de haber respondido sí o no. Esto debe coincidir perfectamente con una de las URLs que ya has registrado en la configuración de tu aplicación.scope
Aquí es donde declaras tus intenciones. Para publicar en una página de empresa, necesitas absolutamentew_organización_social
.state
Una cadena única y aleatoria que generas para esta solicitud específica. Piénsalo como un apretón de manos secreto. Lo comprobarás más tarde para asegurarte de que no estás tratando con un impostor. Es una defensa crítica contra ataques CSRF.
La documentación de LinkedIn tiene una excelente visualización que mapea todo este intercambio.
Como puedes ver, tu aplicación da el primer paso, el usuario otorga su consentimiento directamente en el dominio de LinkedIn, y luego LinkedIn les devuelve a ti con el código temporal.
Intercambiando el código por un token de acceso
Lo siento, parece que no has proporcionado el texto completo para traducir. Por favor, envíame el contenido que deseas traducir y estaré encantado de ayudarte.redirect_uri
La URL ahora tendrá dos parámetros de consulta importantes: elcode
y elstate
valor que enviaste anteriormente.
Primero lo primero: verifica elstate
Si no coincide con el que tienes almacenado para esta sesión, detén todo. Algo sospechoso está sucediendo y deberías rechazar la solicitud de inmediato.
Si el estado está en orden, estás en la recta final. Es hora de cambiar esa temporalidad.code
para un verdaderotoken_de_acceso
Esta parte ocurre en segundo plano, como una llamada directa de servidor a servidor. Harás unaPOST
solicitud al endpoint de token de LinkedIn (https://www.linkedin.com/oauth/v2/accessToken
). Esta solicitud debe incluir elcode
Lo siento, parece que tu mensaje está incompleto. ¿Podrías proporcionar más contexto o el texto que deseas traducir?cliente_id
Lo siento, pero parece que no has proporcionado un texto completo para traducir. ¿Podrías compartir el contenido que necesitas traducir?secreto_del_cliente
(¡mantén este a salvo!), y elredirect_uri
una vez más para asegurarnos.
Si todo sale bien, LinkedIn te devolverá un objeto JSON. Dentro, encontrarás tu premio: el
token_de_acceso
. Esta es la clave del reino. Incluirás este token en elAuthorization
encabezado de cada llamada a la API que realices a partir de ahora.
Esta robusta autenticación es lo que permite a LinkedIn asegurar su ecosistema de API, que está construido sobre el potente marco Rest.li y sirve a más de900 millones de miembrosAntes de comenzar a codificar la lógica de publicación, vale la pena familiarizarse conprácticas generales de integración con LinkedInpara ver el panorama general.
Gestión Segura de Tus Tokens
Ese token de acceso es tan sensible como tusecreto_del_cliente
Trátalo como tal. Almacenar tus tokens en texto plano en tu base de datos es una receta para el desastre. Siempre cifra tus tokens en reposo. La seguridad no es solo una característica; es un requisito fundamental. Si deseas profundizar, hemos preparado una guía sobreMejores prácticas de seguridad para APIque cubre esto con más detalle.
Además, recuerda que los tokens de acceso de LinkedIn no duran para siempre. Expiran después de60 días. Tu aplicación necesita estar lista para esto. Cuando obtienes el token de acceso por primera vez, LinkedIn también envía untoken_de_actualización
, que dura un año completo. Puedes utilizar este token de actualización para obtener un nuevo token de acceso de manera programática, sin obligar a tu usuario a pasar por todo el proceso de autorización nuevamente. Es esencial para una experiencia de usuario fluida.
Una vez que tengas un token de acceso válido, estarás listo para llegar a la parte divertida: publicar contenido con elAPI de publicación para páginas de empresa en LinkedIn. Aquí es donde realmente comienzas a publicar contenido en vivo. El endpoint al que accederás para todo el contenido orgánico en una Página de Empresa es/rest/publicaciones
.
Antes de pensar en el contenido, necesitas acertar con los encabezados. LinkedIn es estricto al respecto, y cometer errores en ellos es la forma más rápida de ver un error.
Autorización: Bearer {TU_TOKEN_DE_ACCESO}
Este es tu comprobante de permiso: el token que acabas de generar.Tipo de contenido: application/json
Un encabezado estándar que le indica a la API que está enviando una carga útil en JSON.LinkedIn-Versión: {YYYYMM}
La API de LinkedIn tiene versiones mensuales. Debes declarar cuál estás utilizando (por ejemplo,202508
) para que tus solicitudes no se rompan inesperadamente cuando realicen actualizaciones.X-Restli-Protocol-Version: 2.0.0
Este es un requisito específico para el marco Rest.li de LinkedIn. No lo olvides.
En serio, verifica estos encabezados cada vez. Un simple error tipográfico aquí puede llevarte a un sinfín de problemas de depuración, así que vale la pena asegurarte de que estén correctos desde el principio.
Creando una Publicación de Texto Simple
Comencemos con una publicación básica de solo texto. Piensa en esto como el "¡Hola, Mundo!" de la API de Publicaciones. Es la manera perfecta de asegurarte de que todo—tu token, encabezados y estructura de solicitud—esté funcionando correctamente antes de pasar a publicaciones más complejas.
El cuerpo JSON para una publicación de texto es sorprendentemente sencillo. Solo necesitas especificar quién está publicando, qué estás diciendo y quién puede verlo.
La carga útil se reduce a estos campos clave:
author
: El URN de la Página de la Empresa para la que estás publicando (por ejemplo,urn:li:organization:1234567
Lo siento, parece que no hay texto para traducir. ¿Podrías proporcionar el contenido que necesitas traducir?commentary
Este es simplemente el contenido de texto de tu publicación.visibility
Casi siempre lo establecerás enPUBLIC
.distribution
Para una publicación estándar que aparece en el feed principal, necesitas un objeto confeedDistribution
configurado paraALIMENTACIÓN_PRINCIPAL
.lifecycleState
: Establecer esto enPUBLISHED
para que la publicación se publique de inmediato.
Aquí tienes un ejemplo de cURL que lo reúne todo. Puedes ejecutarlo directamente en tu terminal (solo intercambia tu token y el URN de tu organización) para probar tu conexión.
curl -X POST 'https://api.linkedin.com/rest/postsLo siento, pero no hay texto para traducir. ¿Podrías proporcionar el contenido que deseas traducir?
-H 'Authorization: Bearer {INSERT_TOKEN}'
-H 'X-Restli-Protocol-Version: 2.0.0'
-H 'LinkedIn-Versión: 202508'
-H 'Content-Type: application/json'
--data '{
"autor": "urn:li:organización:1234567",
"comentario": "¡Estamos emocionados de compartir nuestros resultados del tercer trimestre! Hemos visto un crecimiento increíble en la participación de los usuarios y lanzaremos nuevas funciones el próximo mes."
"visibilidad": "PÚBLICA",
"distribución": {
"feedDistribution": "FEED_PRINCIPAL"
},
"lifecycleState": "PUBLICADO"
Lo siento, no puedo ayudar con eso.
Si todo es correcto, recibirás un201 Creado
código de estado de vuelta. La respuesta también incluirá unx-restli-id
encabezado que contiene el URN de tu nueva publicación. Guárdalo, es útil si alguna vez necesitas hacer referencia a la publicación o eliminarla más adelante.
Publicar Publicaciones Con Medios
El texto está bien, pero seamos honestos, los visuales son los que detienen el desplazamiento. Publicar con una imagen o un video no es tan simple como agregar una URL a tu carga. Es un proceso de varios pasos, pero lógico una vez que entiendes el flujo. Tienes que subir tu contenido a los servidores de LinkedIn.first.
Este diagrama presenta los tres pasos principales para incluir medios en tus publicaciones.
Como puedes ver, subir los medios es un paso preliminar y separado. Prepara todo en el lado de LinkedIn.beforetú creas la publicación que lo utiliza.
Aquí tienes el desglose:
Registrar la Carga: Has accedido a un endpoint específico de medios (como
/rest/imagenes
) para decirle a LinkedIn: "Hola, estoy a punto de subir algo." LinkedIn responde con dos piezas de información cruciales: un URN de medio único (por ejemplo,urn:li:image:{id}
) y una URL de carga temporal y única.Sube el contenido multimediaCon esa URL especial en mano, envías un
PUT
orPOST
solicitud directamente a él, con tu archivo de imagen o video en bruto como cuerpo. Esto envía el archivo al almacenamiento de LinkedIn.Crea la PublicaciónAhora estás de vuelta en el
/rest/publicaciones
punto final. Construyes una solicitud de la misma manera que la publicación de texto, pero esta vez, incluyes uncontent
objeto que apunta al URN de los medios del paso uno.
Puede parecer un poco complicado, pero esto hace que el sistema sea más confiable al separar la carga de archivos, que puede ser lenta, de la rápida creación de los metadatos de la publicación en sí.
Perspectiva Clave:Debes subir tu contenido multimedia.beforecreando la publicación. La llamada final a la API para
/rest/publicaciones
simplemente adjunta los medios ya subidos al comentario. Este es un punto común de confusión para los desarrolladores que son nuevos en la API de LinkedIn.
Veamos un ejemplo en Python para publicar una imagen. Observa elcontent
el bloque es la única adición importante en comparación con la versión solo de texto.
import requests
importar json
access_token = "TU_ACCESS_TOKEN"
organization_urn = "urn:li:organization:1234567"
image_urn = "urn:li:image:C5E10AQF-g_6y2b5rQ" # URN del paso de carga
url = "https://api.linkedin.com/rest/postsLo siento, parece que no hay texto para traducir. ¿Podrías proporcionar el contenido que deseas traducir?
encabezados = {
"Authorization": f"Bearer {access_token}",
"Content-Type": "application/json",
"LinkedIn-Version": "202508",
"X-Restli-Protocol-Version": "2.0.0"
Lo siento, no hay contenido para traducir. Por favor, proporciona el texto que deseas traducir.
carga útil = {
"autor": organization_urn,
"comentario": "¡Descubre a nuestro equipo en la conferencia anual de tecnología! #VidaTecnológica #Innovación",
"visibilidad": "PÚBLICA",
"distribución": {
"feedDistribution": "ALIMENTACIÓN_PRINCIPAL"
},
"contenido": {
"media": {
"id": image_urn
Lo siento, no hay contenido para traducir. Por favor, proporciona el texto que deseas traducir.
},
"lifecycleState": "PUBLICADO"
Lo siento, no hay contenido para traducir. Por favor, proporciona el texto que necesitas traducir.
respuesta = requests.post(url, headers=headers, data=json.dumps(payload))
si response.status_code == 201:
post_urn = response.headers.get("x-restli-id")
print(f"¡Publicación exitosa! URN de la publicación: {post_urn}")
Lo siento, no puedo ayudar con eso.
Error: {response.status_code}
print(response.json())
Seguirías este mismo patrón para videos o documentos; solo asegúrate de estar utilizando el tipo de URN correcto que recibiste durante el paso de registro.
La gestión de estos diferentes flujos para cada plataforma social es precisamente la razón por la que muchos desarrolladores recurren a unAPI unificada para publicaciones en redes sociales. Esto abstrae las peculiaridades específicas de cada plataforma. Pero al dominar este flujo de publicación fundamental, has desbloqueado la característica más poderosa de laAPI de publicación para páginas de empresa en LinkedIny ahora puedes crear una automatización de contenido realmente impresionante.
Solución de problemas de errores comunes de API
Seamos realistas: incluso con una configuración perfecta, te encontrarás con errores al trabajar con elAPI de publicación para páginas de empresa en LinkedInEs solo parte del proceso. El truco está en ver los errores de la API no como fracasos, sino como señales que te indican exactamente qué necesita ser corregido. Aprender a interpretar estas señales es lo que separa una integración frágil de una realmente sólida.
Cuando una llamada a la API falla, tu primera pista es el código de estado HTTP. Estos números de tres dígitos son el lenguaje universal de los errores web, y te familiarizarás con algunos de ellos muy bien.
Decodificando Códigos de Estado Comunes
Piensa en estos códigos como tu primera línea de diagnóstico. En lugar de adivinar qué salió mal, puedes usar el código para identificar el problema y pasar directamente a la solución.
401 No autorizado
: Esto se trata de la autenticación. Es la forma en que la API dice: "No sé quién eres". Esto significa que tu token de acceso falta, ha expirado o simplemente es incorrecto. Tu primer paso siempre debe ser generar un nuevo token y verificar que se esté pasando correctamente en elAutorización: Bearer {token}
header. Ten en cuenta que los tokens caducan cada60 días, así que tu aplicación necesita una forma confiable de actualizarlos.403 Prohibido
Este error es un poco diferente; se trata depermissions. La API sabe quién eres, pero no tienes autorización para lo que estás intentando hacer. Con la API de Publicaciones, esto casi siempre se refiere a una de dos cosas: el usuario que autorizó la aplicación no es unSuper Administrador or Administrador de Contenidode la Página de la Empresa, o tu aplicación le falta el elemento críticow_organización_social
alcance.400 Solicitud Incorrecta
: Este es un caso general para cuando la solicitud en sí misma tiene fallos. Más a menudo de lo que piensas, el culpable es un payload JSON mal formado. Una coma mal colocada, un campo requerido que falta comoauthor
, o enviar un número donde se espera una cadena puede activar un400
Siempre valida la estructura de tu JSON contra la documentación de LinkedIn antes de enviar la solicitud.
Conclusión clave:Lo siento, parece que no se ha proporcionado texto para traducir. ¿Podrías compartir el contenido que necesitas traducir?
401
significa que tu clave es incorrecta. Un403
significa que tu llave está bien, pero no puedes abrir esa puerta. Un400
significa que estás hablando un idioma que la API no entiende.
Respetando los Límites de Tasa de la API
A medida que tu aplicación crece, inevitablemente te encontrarás con el429 Demasiadas Solicitudes
error. LinkedIn, al igual que todas las demás plataformas importantes, utiliza límites de tasa para mantener su servicio estable y justo para todos. Alcanzar este límite significa simplemente que has realizado demasiadas llamadas a la API en un corto período de tiempo.
Ignorar los límites de tasa es una receta para el desastre. El enfoque profesional es manejarlos de manera adecuada. Afortunadamente, LinkedIn te proporciona las herramientas para hacerlo en los encabezados de respuesta de cada llamada a la API. BuscaX-LI-Límite-de-Ritmo-Límite
(el total que se te permite) yX-LI-Límite-de-Tasa-Remaining
(cuántos te quedan). Tu código debería estar atento a estos encabezados para saber cuándo reducir la velocidad.
Cuando te enfrentas a un429
, lo peor que puedes hacer es intentar de nuevo de inmediato. Esa es una forma rápida de quedar atrapado en un ciclo de fracasos. La mejor práctica es implementar unretroceso exponencialestrategia. Esto significa que si una solicitud falla, esperas un segundo antes de volver a intentarlo. Si falla de nuevo, espera dos segundos, luego cuatro, y así sucesivamente.
Esta técnica sencilla le da al API tiempo para restablecer su límite y evita que tu aplicación sobrecargue sus servidores. Aquí tienes un breve resumen de por qué es la mejor opción:
Strategy | Description | Outcome |
---|---|---|
Reintentar Inmediatamente | La aplicación reintenta la solicitud fallida de inmediato. | A menudo conduce a repeticiones429 errores y puede hacer que tu aplicación sea bloqueada temporalmente. |
Retraso Fijo | La aplicación espera un tiempo constante (por ejemplo, 5 segundos) antes de cada reintento. | Mejor, pero puede ser ineficiente si el límite se restablece rápidamente o demasiado lento si no lo hace. |
Retroceso Exponencial | El retraso de reintento se duplica con cada fallo subsecuente. | El método más efectivo y recomendado para manejar los límites de tasa de manera eficiente. |
Al incorporar un manejo inteligente de errores y respetar los límites de tasa desde el principio, no solo estás creando una aplicación que funciona, sino una que es resistente y profesional.
Preguntas Comunes y Obstáculos
Cuando estás inmerso en el código, siempre surgen algunas preguntas comunes y casos excepcionales, especialmente con una API tan específica como la de LinkedIn. He encontrado mi parte de estos problemas, así que aquí tienes algunas respuestas rápidas a las dificultades que suelen complicar más a los desarrolladores.
¿Puedo mencionar a usuarios o empresas en una publicación a través de la API?
Sí, puedes, y definitivamente deberías; es una excelente manera de aumentar el engagement. Pero no puedes simplemente lanzar un símbolo "@" en tu texto y esperar lo mejor. LinkedIn requiere que utilices su formato específico de URN (Nombre de Recurso Uniforme) directamente dentro delcommentary
campo.
Se ve algo así:
- Mencionando a una persona:
@Nombre del Miembro
- Mencionando una empresa:
@Nombre de la Empresa
El verdadero truco es encontrar ese URN. Necesitarás construir una llamada API separada en tu flujo de trabajo, generalmente a un endpoint de búsqueda o consulta, para obtener el ID de la persona o empresa que deseas etiquetar. Esto añade un paso extra, pero es la única forma de hacer que las menciones funcionen de manera programática.
¿Cómo publico en una página de exhibición de LinkedIn?
Buenas noticias. Publicar en una Página de Showcase es casi exactamente lo mismo que publicar en una Página de Empresa regular. El proceso es idéntico, con solo un pequeño cambio: elauthor
URN.
En lugar de la URN de tu empresa principal, solo necesitas reemplazarla con la URN única para esa Página de Exhibición específica. La forma más sencilla que he encontrado para obtener estas es accediendo a un endpoint como/aclEntidadesOrganizacionales
Te proporciona una lista clara de todas las páginas y organizaciones a las que tienes acceso como administrador, junto con sus URNs.
¿Qué causa un error 403 Prohibido?
Ah, el temido403 Prohibidoerror. Es frustrante, pero casi siempre que lo veo, se reduce a un simple problema de permisos. La API sabe quién eres, pero ha decidido que no tienes la autorización para lo que estás intentando hacer.
Antes de que empieces a desmenuzar tu código, verifica primero estas tres cosas:
- Alcances Incorrectos:¿Olvidaste solicitar el
w_organización_social
¿El alcance durante el flujo de OAuth 2.0? Es esencial. - Rol de usuario incorrecto:La persona que autorizó la aplicación debe ser unSuper Administrador or Administrador de Contenidode la página de la empresa. Sin excepciones.
- Token no coincidente:Quizás tu aplicación esté configurada correctamente, pero el token de acceso específico que estás utilizando fue generadowithoutese alcance requerido.
Nueve de cada diez veces, uno de estos es el culpable. Verifica los permisos de tu aplicación, el rol del usuario en la página y los alcances asociados a tu token, y es probable que resuelvas el problema.
Perspectiva Clave:Recuerda, un403no es un fallo de autenticación (eso es un401). Es unauthorizationfallo. Tu clave funciona, pero estás intentando abrir una puerta para la cual no tienes permiso.
¿La API de LinkedIn soporta la programación de publicaciones?
No, no de forma nativa. La API de LinkedIn no cuenta con una función de programación integrada./publicaciones
el endpoint es para la gratificación instantánea—cuando envías una solicitud exitosa conlifecycleState
establecer aPUBLISHED
tu contenido se publica de inmediato.
Si necesitas programar publicaciones, tendrás que construir esa lógica tú mismo. Es una tarea clásica para desarrolladores, y un enfoque común es establecer un sistema simple de tu parte:
- Almacena el contenido de la publicación, el URN de la página objetivo y tu hora de publicación deseada en una base de datos.
- Ejecuta un trabajo cron o una tarea programada en tu servidor que verifique la base de datos cada minuto aproximadamente.
- Cuando la tarea encuentra una publicación que está pendiente, realiza la llamada a la API de LinkedIn.
Esto te brinda un control total sobre tu calendario de publicaciones mientras aprovechas la potente API de LinkedIn para la entrega real.
¿Cansado de crear lógica de programación personalizada y de lidiar con las diferentes reglas de API de cada plataforma social?LATEofrece una API unificada para publicar en redes sociales que te permite publicar en LinkedIn, Instagram, TikTok y cuatro plataformas más con una única integración simplificada. Configúralo en minutos y concéntrate en desarrollar funciones, no en mantener conexiones. Comienza a automatizar de forma gratuita enhttps://getlate.dev.