계정과 지원 기능
워크스페이스와 계정 ID를 선택하고 사용할 수 있는 작업을 확인하세요.
워크스페이스 선택
REST 키는 워크스페이스 하나에 연결됩니다. GET /api/v1/workspaces는 그 워크스페이스만 반환하며 요청에 사용하는 계정·미디어 ID도 같은 워크스페이스에 속해야 합니다. 소셜 계정 연결은 Posteady의 계정 페이지에서 진행합니다. 공개 API는 이미 연결된 계정을 조회합니다.
MCP는 OAuth로 사용자가 접근할 수 있는 적격 워크스페이스를 사용합니다. 읽기 도구는 여러 워크스페이스를 조회할 수 있고, 쓰기 도구는 대상 계정에서 워크스페이스를 결정합니다. MCP에 workspaceId를 지정했다면 대상과 일치해야 합니다. MCP 도구를 참고하세요.
계정 찾기
curl --request GET "https://www.posteady.com/api/v1/accounts" \
--header "Authorization: Bearer $POSTEADY_API_KEY"응답의 accounts 배열에서 accountId를 찾아 발행 요청에 사용하세요. 플랫폼의 원래 사용자 ID와 다릅니다. provider·username·displayName으로 연결을 구분할 수 있습니다. X는 isPremium, LinkedIn과 Instagram은 accountType도 포함합니다.
지원 기능 확인
| 필드 | 작업 |
|---|---|
readPosts | 동기화된 게시물·지표 조회 |
publishPosts | 허용된 형식 발행 |
schedulePosts | 허용된 형식 예약 |
repostPosts | 플랫폼 게시물 리포스트 |
Threads·X·LinkedIn은 네 capability를 모두 제공합니다. TikTok·Instagram·YouTube·Facebook은 이 API를 통한 리포스트를 지원하지 않습니다. 형식과 연결 요건은 플랫폼 개요에서 확인하세요.
Capability는 연결된 계정이 지원하는 작업을 나타냅니다. 요청 시 플랜·작업 권한 검증은 별도로 수행합니다. 지원하는 작업이라도 연결 토큰이 만료되면 실패할 수 있습니다.
Instagram·YouTube·Facebook 쓰기 capability는 현재 연결 상태와 허용된 권한에 따라 달라집니다. Facebook은 공개 쓰기 제공 상태도 확인합니다. 쓰기 작업을 노출하기 전에 반환값을 확인하세요. false는 권한 누락·재연결 필요·일시적인 제공 제한을 뜻할 수 있습니다.
여러 계정 선택
텍스트 요청에는 같은 워크스페이스의 Threads·X·LinkedIn 계정 1–5개를 넣을 수 있으며 각 플랫폼의 글자 수 제한이 적용됩니다. TikTok·Instagram·YouTube·Facebook 요청은 각각 계정 하나만 대상으로 하며 전용 발행 형식을 사용합니다.