Posteady
Posteady Docs
가이드API 레퍼런스MCP
API 레퍼런스카드뉴스

카드뉴스 조회

카드뉴스가 완성됐는지 확인하고 발행에 쓸 렌더된 장 이미지를 받습니다.

GET
/api/v1/carousels/{id}
curl -X GET "https://example.com/api/v1/carousels/cccccccc-cccc-4ccc-8ccc-cccccccccccc"

{  "carouselId": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",  "status": "processing"}

API 키의 워크스페이스에 속한 카드뉴스의 생성 상태와 결과를 반환합니다. 생성 요청에서 받은 carouselId를 사용하세요. status가 completed이면 images에 렌더된 장이 순서대로 들어 있습니다. 각 mediaId를 발행 또는 예약 요청에 넘기고, 원하면 caption을 게시물 본문으로 사용하세요. 실패한 카드뉴스에는 오류 코드와 설명이 포함됩니다. 실패하면 생성 크레딧은 환불됩니다. 단, RENDER_FAILED는 카드뉴스가 저장된 상태이므로 환불되지 않으며 Posteady 편집기에서 마무리할 수 있습니다. 이 엔드포인트는 저장된 상태만 읽으며 새 생성을 시작하지 않습니다.

인증

apiKey
인증Bearer <token>

위치: header

경로 매개변수

id*string
형식uuid

응답 본문

application/json

application/json

application/json