가이드시작하기
빠른 시작
API 키를 발급하고 네 단계로 첫 텍스트 게시물을 발행하세요.
연결된 Threads·X·LinkedIn 계정 중 하나로 시작하세요. 아래 UUID와 응답은 합성 예시이므로 실제 계정 ID로 바꿔야 합니다.
베이스 URL: https://www.posteady.com/api/v1
1. API 키 발급
크리에이터 플랜 이상인 워크스페이스에서 설정의 API 키 탭을 열고 키를 발급하세요. 키 전체는 발급 직후 한 번 표시됩니다. 서버나 로컬 셸의 환경 변수에 저장하세요.
API 키 발급받기export POSTEADY_API_KEY="pk_replace_with_your_key"2. 계정 ID 선택
curl --request GET "https://www.posteady.com/api/v1/accounts" \
--header "Authorization: Bearer $POSTEADY_API_KEY"응답에서 provider가 threads, x, linkedin 중 하나이고 publishPosts가 true인 계정의 accountId를 복사하세요.
{
"accounts": [
{
"accountId": "11111111-1111-4111-8111-111111111111",
"provider": "threads",
"username": "example",
"displayName": "Example",
"capabilities": {
"readPosts": true,
"publishPosts": true,
"schedulePosts": true,
"repostPosts": true
}
}
]
}3. 첫 글 발행
accountIds를 방금 복사한 ID로 바꾸세요. 이 요청은 연결된 계정에 실제로 글을 발행합니다.
curl --request POST "https://www.posteady.com/api/v1/posts" \
--header "Authorization: Bearer $POSTEADY_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"accountIds": [
"11111111-1111-4111-8111-111111111111"
],
"posts": [
"Hello from Posteady!"
]
}'4. 결과 확인
Threads 텍스트 발행이 성공하면 HTTP 200과 다음 형태의 응답을 받습니다. 계정별 success와 발행된 postIds를 확인하세요.
{
"results": [
{
"accountId": "11111111-1111-4111-8111-111111111111",
"provider": "threads",
"username": "example",
"success": true,
"postIds": [
"18000000000000000"
]
}
],
"summary": {
"succeeded": 1,
"failed": 0
}
}여러 계정 중 일부만 실패해도 HTTP 200일 수 있습니다. summary.failed가 0보다 크면 실패한 결과를 확인하세요. 미디어 플랫폼은 HTTP 202로 작업을 접수하므로 별도로 발행 상태를 추적해야 합니다.