Quickstart

이 페이지는 REST API를 코드로 직접 부르는 방법이에요. 쓰던 AI에 연결하고 싶다면 MCP로 연결하기를 먼저 봐 주세요.

기본 주소

https://api.posendy.com/v1

이 문서에 나오는 엔드포인트는 모두 이 주소를 앞에 붙여서 불러요.

네 단계

1. API 키 받기: 대시보드 > API Keys에서 새 키를 만들어요. 키 원문은 만들 때 한 번만 보여요. 바로 안전한 곳에 적어 두세요.
2. 채널 연결: 대시보드 > Connections에서 올릴 채널을 연결해요. 연결한 채널에만 글을 올릴 수 있어요.
3. 미디어 올리기 (선택): presign으로 자리를 받고, 파일을 올리고, 완료를 알려요. 글만 올린다면 이 단계는 넘어가요.
4. 발행: POST /v1/posts를 한 번 부르면 고른 채널 전부에 글이 나가요.

curl -X POST https://api.posendy.com/v1/posts \
  -H "authorization: Bearer $POSENDY_KEY" \
  -H "content-type: application/json" \
  -d '{"content":"Hello from posendy","accountIds":["acc_01H..."]}'

키 다루는 법은 인증, 채널 id 찾는 법은 채널 연결, 파일 올리는 법은 미디어에 있어요.

자주 묻는 것

첫 호출 전에 무엇이 준비돼 있어야 해요?

세 가지예요. 이메일 인증을 마친 계정, 연결된 채널 하나 이상, API 키. 이메일 인증 전이거나 연결된 채널이 없으면 발행 요청이 거절돼요.

글만 올릴 때도 미디어가 필요해요?

글만으로 올라가는 채널이면 필요 없어요. 사진이나 영상이 꼭 있어야 하는 채널은 글만 보낸 요청을 발행 전에 거절해요. 채널별로 무엇이 필요한지는 플랫폼 페이지의 제한 표에서 확인해요.

코드를 안 짜도 쓸 수 있어요?

네. 이 페이지는 코드로 쓰는 방법일 뿐이에요. AI에게 말로 시키고 싶다면 MCP로 연결하면 되고, 그 방법은 API 키가 아예 필요 없어요.