게시물 발행

curl -X POST "https://example.com/api/v1/posts" \  -H "Content-Type: application/json" \  -d '{    "accountIds": [      "11111111-1111-4111-8111-111111111111"    ],    "posts": [      "Hello from the Posteady API!"    ]  }'

{  "results": [    {      "accountId": "11111111-1111-4111-8111-111111111111",      "provider": "threads",      "username": "your_brand",      "success": true,      "postIds": [        "18000000000000001"      ]    }  ],  "summary": {    "succeeded": 1,    "failed": 0  }}

Threads, X, LinkedIn에 텍스트를 발행하거나 TikTok, Instagram, YouTube, Facebook에 미디어 발행 작업을 접수합니다. 대상 플랫폼에 맞는 요청 예제를 선택하세요. 모든 계정 ID는 API 키의 워크스페이스에 속해야 합니다.

발행 형식 선택

• 텍스트: accountIds와 posts를 사용합니다. 여러 글은 Threads와 X에서 연속 글로 발행되며 LinkedIn은 글 하나만 허용합니다.
• TikTok: 계정 하나와 캡션 하나를 지정하고 posts와 video를 함께 사용합니다.
• Instagram, YouTube, Facebook: 해당 플랫폼 객체와 계정 하나를 지정합니다. posts와 다른 발행 형식의 객체는 생략하세요.
• 미디어: 파일을 업로드하고 확인을 마친 뒤 mediaId를 사용합니다. 선택한 게시 유형에 맞는 이미지나 동영상을 사용하세요.

X 게시물의 링크

X는 첫 게시물(posts[0])에서 링크를 자동 제거합니다. http://, https://, www.와 foo.com, foo.io/path처럼 프로토콜 없는 도메인이 대상이며 경로·쿼리 문자열·프래그먼트도 함께 제거합니다. 답글인 posts[1] 이후의 링크는 유지하며 같은 요청의 다른 플랫폼에는 원문을 전달합니다. X에 링크를 공유하려면 답글에 직접 넣으세요. 제거한 링크를 답글로 자동 이동하지는 않습니다. X 글자 수는 제거 후 검증합니다. 첫 글에 빈 문자열이나 공백만 남으면 어떤 계정에도 발행하기 전에 요청 전체가 VALIDATION_ERROR(HTTP 422)로 실패합니다. 입력과 실제 본문 예제는 X 가이드를 참고하세요.

결과 확인

텍스트 발행은 계정별 결과를 반환합니다. HTTP 200 응답에서도 각 success 값을 확인하세요. 비동기 작업 접수는 HTTP 202와 results[0].jobId를 반환합니다. 이때 success: true는 접수 성공이며 실제 발행은 GET /api/v1/publish-jobs/{id}로 확인하세요.

미디어 요청 재시도

동일한 UUID requestId와 변경하지 않은 입력으로 재시도하면 기존 작업을 반환합니다. 같은 ID에 다른 입력을 보내면 REQUEST_CONFLICT가 발생합니다. Facebook은 진행 중인 작업에 HTTP 202, 종료된 작업 재요청에 HTTP 200을 반환하며 failed·canceled·unknown은 success: false입니다. 다른 미디어 플랫폼의 실패한 종료 작업 재요청은 HTTP 502를 반환합니다. 텍스트 요청에는 이 중복 방지 보장이 없습니다.

응답 본문