인증

모든 REST 요청은 워크스페이스 API 키를 사용합니다. 대상 워크스페이스를 선택한 상태에서 Posteady 설정 → API 키를 열어 발급하세요. 크리에이터 플랜 이상이 필요합니다.

키 전송

export POSTEADY_API_KEY="pk_replace_with_your_key"
curl https://www.posteady.com/api/v1/accounts \
  --header "Authorization: Bearer $POSTEADY_API_KEY"

키 전체는 발급 직후 한 번 표시되며 목록에서 다시 읽을 수 없습니다. 서버 환경 변수나 비밀 관리 도구에 저장하세요. 브라우저 코드나 공개 저장소에는 넣지 마세요.

워크스페이스와 권한

키 하나는 워크스페이스 하나를 선택합니다. REST 요청에 workspaceId를 넣어 변경할 수 없습니다. 다른 워크스페이스에 접근하려면 해당 워크스페이스에서 키를 발급하세요. 매 요청마다 키 소유자의 현재 멤버십·역할·작업 권한을 검사하므로 회수된 권한이 기존 키에 남지 않습니다.

GET /api/v1/workspaces는 키에 연결된 워크스페이스를 반환합니다. 계정과 지원 기능을 참고하세요.

키 폐기와 교체

연동이 더 이상 필요 없거나 키가 노출되면 API 키 설정 탭에서 폐기하세요. 키를 교체할 때는 새 키 발급 → 연동 설정 변경 → 이전 키 폐기 순서로 진행합니다. 무효하거나 폐기된 키는 401 UNAUTHENTICATED를 반환합니다.

빠른 시작, 오류 해결, AI 클라이언트용 MCP 인증으로 이어가세요.