예약 목록

01 예약 목록

1.1 설명

GET/publishes

from 과 to 로 기간을 좁힐 수 있습니다. from 은 그 시각을 포함하고 to 는 포함하지 않으므로, 기간을 이어 붙여도 경계의 예약이 두 번 세지 않습니다.

한 줄에는 그 예약이 가리키는 콘텐츠의 제목·본문·형태가 같이 실립니다. 달력 한 칸을 그리려고 콘텐츠를 다시 부르지 않아도 됩니다.

1.2 파라미터

예약 목록 파라미터
이름	구분	설명
`workspace`	필수	워크스페이스 코드
`from`	선택	이 시각부터(포함). UTC 오프셋을 포함한 ISO-8601(`2026-09-01T00:00:00Z`)
`to`	선택	이 시각 전까지(제외). 형식은 `from` 과 같습니다

1.3 요청

Terminal — bash

curl "https://moacast.com/api/moacast/v1/publishes?workspace=a1b2c3d4&from=value" \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

1.4 성공 응답

Response — JSON

{
    "result": "SUCCESS",
    "result_code": 0,
    "data": {
        "workspace": "a1b2c3d4",
        "items": [
            {
                "id": 34,
                "content_id": 12,
                "channel": "youtube",
                "external_id": "UC...",
                "title": "9월 넷째 주 요약",
                "body": "이번 주에 있었던 일",
                "content_type": "video",
                "status": "SCHEDULED",
                "publish_at": "2026-09-28T01:00:00+00:00",
                "visibility": "public"
            }
        ]
    }
}

1.5 필드

예약 목록 필드
필드	타입	설명
`workspace`	`string`	워크스페이스 코드
`items`	`array`	예약 목록. 예약 시각이 이른 것부터. 한 줄의 모양은 아래와 같습니다

items 의 한 줄

예약 목록 필드
필드	타입	설명
`id`	`int`	예약 ID
`content_id`	`int`	그 예약이 가리키는 콘텐츠 ID
`channel`	`string`	채널 키. `youtube` · `instagram` · `facebook` · `threads` · `tiktok` · `x` · `linkedin`
`external_id`	`string`	예약한 계정의 식별자입니다. 같은 플랫폼에 계정이 여럿일 때 어느 계정의 예약인지 이 값으로 가릅니다
`title`	`string`	콘텐츠의 공통 제목
`body`	`string`	콘텐츠의 공통 본문 또는 설명
`content_type`	`string`	`video` · `text` · `article` · `image`
`status`	`string`	`SCHEDULED` · `PUBLISHED` · `FAILED` · `CANCELLED`
`publish_at`	`string`	예약 시각. UTC 기준 ISO-8601 입니다
`visibility`	`string`	`public` · `unlisted` · `private`

1.6 실패

예약 목록 실패
코드	HTTP	언제
`9912`	400	`workspace` 를 주지 않았습니다
`1004`	400	`from` 또는 `to` 의 시각 형식이 올바르지 않습니다
`1001`	401	헤더가 없거나 토큰이 올바르지 않습니다
`2000`	404	그 워크스페이스가 없거나, 이 토큰으로 다룰 수 없습니다
`5000`	503	예약 저장소가 준비되지 않았습니다

한 번에 돌려주는 줄 수는 200개로 고정입니다. 더 봐야 하면 기간을 좁혀 여러 번 부르십시오.