LinkedIn 공개 API의 연결 요건·발행 예제·제한.
연결 요건
연결된 LinkedIn 개인 또는 조직 계정을 선택하세요. GET /accounts는 accountType을 포함하며 쓰기 전에 capabilities.publishPosts를 확인해야 합니다.
지원 형식
요청당 텍스트 글 하나를 지원합니다. 텍스트 계정 최대 5개를 대상으로 할 수 있지만 LinkedIn이 포함되면 posts는 반드시 한 항목이어야 합니다. 공개 API 입력은 LinkedIn 이미지·영상·문서를 지원하지 않습니다.
최소 발행 요청
계정·미디어 UUID는 합성 예시이므로 실제 값으로 바꾸세요. API 키는 POSTEADY_API_KEY 환경 변수로 설정합니다.
curl --request POST "https://www.posteady.com/api/v1/posts" \
--header "Authorization: Bearer $POSTEADY_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"accountIds": [
"11111111-1111-4111-8111-111111111111"
],
"posts": [
"Our latest release is ready."
]
}'성공 확인
HTTP 200 응답의 계정별 success·postIds와 summary.failed를 확인하세요. 일부 계정이나 체인 뒷부분이 실패할 수 있으므로 HTTP 코드만으로 전체 성공을 판단하지 마세요.
예약·조회·관련 작업
예약은 같은 플랫폼 입력에 미래 scheduledAt과 선택 timezone을 추가하여 /scheduled-posts로 보내세요. 비동기 플랫폼은 UUID requestId를 새 작업마다 생성하고 재시도 때 유지합니다.
예약과 취소 · 게시물·지표 조회 · 재시도 · MCP 도구
제한과 오류
텍스트는 유니코드 문자 최대 3,000개입니다. LinkedIn 대상은 스레드 체인을 거부하지만 같은 요청의 다른 대상은 성공할 수 있습니다. 원래 게시물 ID는 LinkedIn의 urn:li:share:… 또는 urn:li:ugcPost:…이며 지원되는 리포스트 작업에 사용할 수 있습니다. 토큰이 만료되면 계정을 다시 연결하세요.