예약 생성
연결된 계정에 텍스트나 미디어를 발행할 미래 시각을 지정합니다.
curl -X POST "https://example.com/api/v1/scheduled-posts" \ -H "Content-Type: application/json" \ -d '{ "accountIds": [ "11111111-1111-4111-8111-111111111111" ], "posts": [ "Hello from the Posteady API!" ], "scheduledAt": "2026-10-01T00:00:00Z", "timezone": "Asia/Seoul" }'{ "results": [ { "accountId": "11111111-1111-4111-8111-111111111111", "provider": "threads", "username": "your_brand", "success": true, "scheduledPostIds": [ "55555555-5555-4555-8555-555555555555" ], "scheduledAt": "2026-10-01T00:00:00Z" } ], "summary": { "succeeded": 1, "failed": 0 }}capabilities.schedulePosts=true인 계정에 Threads·X·LinkedIn 텍스트, TikTok 공개 동영상 하나, Instagram FEED·REELS·STORIES, YouTube 동영상 하나, Facebook 페이지 FEED·REELS·STORY를 예약합니다. 미디어는 즉시 발행과 같은 입력을 사용하며 scheduledPostIds, jobId, status를 반환합니다. 취소에는 scheduledPostIds, 진행 조회에는 jobId를 사용하세요. 예약 시각은 미래여야 합니다. Facebook은 진행 중인 작업에 HTTP 202, 종료된 작업의 모든 재요청에 HTTP 200을 반환하며 failed·canceled·unknown은 success=false를 유지합니다.
X는 요청 접수 시 예약을 저장하기 전에 첫 게시물(posts[0])에서 링크를 자동 제거합니다. http://, https://, www.와 foo.com, foo.io/path처럼 프로토콜 없는 도메인이 대상이며 경로·쿼리 문자열·프래그먼트도 함께 제거합니다. 답글인 posts[1] 이후의 링크와 다른 플랫폼의 원문은 유지합니다. X 글자 수는 제거 후 검증합니다. 첫 글에 빈 문자열이나 공백만 남으면 예약을 생성하기 전에 요청 전체가 VALIDATION_ERROR(HTTP 422)로 실패합니다. 기존 예약과 나중에 웹 편집기에서 수정하는 글에는 이 규칙을 적용하지 않습니다. 예제는 X 가이드를 참고하세요.
인증
apiKey 위치: header
요청 본문
application/json
TypeScript 타입
TypeScript에서 request body 타입을 사용하세요.
Threads, X, LinkedIn에는 텍스트를 발행합니다. 공개 TikTok 동영상 하나에는 video, Instagram 미디어 게시물 하나에는 instagram, YouTube 동영상 하나에는 youtube, Facebook 페이지 게시물 하나에는 facebook을 사용합니다. TikTok은 posts와 video를 함께 사용합니다. Instagram, YouTube, Facebook은 각각 독립된 발행 형식으로 다른 발행 형식과 함께 보낼 수 없습니다.
Threads, X, LinkedIn에는 텍스트를 발행합니다. 공개 TikTok 동영상 하나에는 video, Instagram 미디어 게시물 하나에는 instagram, YouTube 동영상 하나에는 youtube, Facebook 페이지 게시물 하나에는 facebook을 사용합니다. TikTok은 posts와 video를 함께 사용합니다. Instagram, YouTube, Facebook은 각각 독립된 발행 형식으로 다른 발행 형식과 함께 보낼 수 없습니다.
응답 본문
application/json
application/json
application/json
application/json
application/json
application/json