Hapi
블로그

· 2분 분량

API로 소셜 미디어 글 예약하기: X, LinkedIn, Bluesky를 호출 한 번에

X, LinkedIn, Bluesky에 글을 코드로 예약하는 실무 가이드입니다. 시간대, 재시도, 웹훅은 대신 처리됩니다.

CMS, 뉴스레터 도구, AI 콘텐츠 어시스턴트처럼 제품에 예약을 넣으면, 네트워크마다 처리 방식이 다르다는 걸 바로 알게 됩니다. 네이티브 예약이 제한적인 곳도 있고, 아예 없는 곳도 있으며, 인증과 제한, 실패 방식도 제각각입니다.

보통의 답은 글을 저장하고, 맞는 시각에 작업을 돌리고, API를 하나씩 호출하는 것입니다. 그러면 스케줄러, 재시도 정책, 토큰 갱신, 사용자에게 보여 줄 오류 상태를 여러분이 갖게 됩니다.

더 짧은 방법이 있습니다.

요청 한 번의 버전

bash
curl -X POST https://hapi.tools/v1/posts \
  -H "Authorization: Bearer $HAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: campaign-42-post-1" \
  -d '{
    "content": "Our winter release is live. Here is what is new 👇",
    "platforms": ["x", "linkedin", "bluesky"],
    "scheduledAt": "2026-12-01T09:00:00-03:00",
    "timezone": "America/Sao_Paulo"
  }'

일어나는 일은 이렇습니다.

  1. Hapi는 받아들이기 전에 콘텐츠를 각 플랫폼의 실제 제한과 대조합니다. Bluesky나 X에 너무 긴 문구라면, 오전 9시의 실패가 아니라 지금 검증 오류가 납니다.
  2. 글은 그 정확한 시각으로 예약되고, 계획한 시간대와 함께 표시됩니다.
  3. 게시 시각이 되면 Hapi가 토큰을 갱신한 뒤 계정마다 게시하고, 계정별 결과를 기록합니다.
  4. 웹훅 엔드포인트는 결과마다 서명된 post.published 또는 post.failed 이벤트를 받습니다.

시차를 놓치지 않기

scheduledAt은 항상 오프셋이 있는 ISO 8601 타임스탬프(2026-12-01T09:00:00-03:00)나 UTC(2026-12-01T12:00:00Z)로 보내세요. 오프셋이 없는 시각은 검증 오류로 거절되므로, 서버 시계 때문에 엉뚱한 시간에 나가는 일은 없습니다. America/Sao_Paulo 같은 IANA timezone을 더하면, 어느 현지 시각으로 계획한 글인지 기록됩니다.

팁: 오프셋은 날짜 라이브러리에 맡기면 서머타임 변경도 처리됩니다. Luxon에서는 DateTime.fromISO("2026-12-01T09:00", { zone: "America/Sao_Paulo" }).toISO()가 2026-12-01T09:00:00.000-03:00을 돌려주고, Hapi는 이를 그대로 받습니다.

네트워크마다 다른 문구

LinkedIn은 긴 글이 더 잘 통하고, Bluesky는 300자까지이며, X도 자기 제한이 있습니다. platformOptions로 같은 요청 안에서 각각을 맞추세요.

json
"platformOptions": {
  "linkedin": { "content": "Our winter release is live.\n\nThree things our customers asked for most: ..." },
  "bluesky": { "content": "Winter release is live ❄️ hapi.tools/changelog" }
}

실패를 바로 알기

직접 만든 시스템에서는 예약 글이 조용히 실패하는 경우가 많습니다. Hapi는 모든 웹훅을 HMAC-SHA256으로 서명하고, 지수 백오프로 전달을 재시도합니다(최대 6번).

text
hapi-signature: t=1764590400,v1=5f2b...

서명을 확인한 뒤 사용자에게 바로 알려 주세요. “계정이 연결 해제되어 LinkedIn 글이 나가지 않았습니다. 다시 연결할까요?”

다시 예약하거나 취소하기

예약된 글도 다른 리소스와 같습니다. 가져오고, scheduledAt을 바꾸고, /v1/posts/{id}로 지우면 됩니다. 팀이 손으로 관리하고 싶다면 Hapi 대시보드에도 끌어다 놓는 캘린더가 있습니다.

지금 라이브인 플랫폼

오늘 기준으로 예약과 게시는 X, LinkedIn, Bluesky, Telegram, Discord, Slack에서 라이브입니다. Instagram, TikTok, YouTube, Threads, Facebook, Pinterest 등은 샌드박스 모드로 쓸 수 있습니다. API는 같고, 실제 플랫폼 제한으로 검증되며, 결과는 시뮬레이션입니다. UI를 지금 만들고 테스트한 뒤, 라이브가 되면 전환하면 됩니다.

직접 해 보기

무료 키를 만들고 첫 글을 예약하세요 →

15일 동안 $5로 모든 기능을 써 보세요. Growth는 계정 25개, 월 게시물 5,000개, 웹훅이 월 $49입니다. 요금제를 보세요.