organic-social

Zernio Social

Zernio 발행 API 하나로 여러 플랫폼에 오가닉 포스트를 올리고 예약한다. 콘텐츠 캘린더 자동화의 실행 레이어. (API 사실관계 검증: 2026-07)

발행 게이트 (MANDATORY)

에이전트의 상한선은 "유저 승인 하의 예약"이다. "만들어줘/써줘"는 발행 승인이 아니다 — "올려줘/스케줄해줘"가 승인이며, 목적지(플랫폼)별로 받는다. 자동화 루프(캘린더)도 최초 셋업 때 캘린더 전체를 승인받고, 콘텐츠가 바뀌면 다시.

Setup

• 계정: zernio.com 가입 → Dashboard → Accounts → 각 플랫폼 연결. Instagram은 Business/Creator 계정만 API 게시 가능 (개인 계정은 IG 앱에서 전환: 설정 → 계정 유형 및 도구 → 프로페셔널 계정으로 전환).
• 키: env ZERNIO_API_KEY. Base https://zernio.com/api/v1, Authorization: Bearer.
• VERIFY: GET /v1/profiles 200 + GET /v1/accounts에 대상 플랫폼 accountId.
• Windows: 모든 호출 Python urllib + utf-8 (curl+cp1252는 이모지 응답에 크래시 — 실제 중복 게시 사고의 원인이었다).

A. 미디어 업로드 (presign)

POST /media/presign   { "filename": "...", "contentType": "video/mp4" }
→ { uploadUrl, publicUrl }
→ PUT 바이트를 uploadUrl로 (긴 영상은 timeout ≥ 1800s)
→ publicUrl을 mediaItems에 사용

B. 포스트 생성 (즉시 / 예약)

POST /posts
{ "content": "캡션...",
  "mediaItems": [{ "url": "https://...", "thumbnail": "https://..." }],
  "platforms": ["instagram", "youtube"],
  "scheduledFor": "2026-07-20T09:00:00Z", "timezone": "Asia/Seoul" }
  // 또는 "publishNow": true

• 한 포스트로 여러 플랫폼 동시 타깃 — 같은 시각에 함께 나간다.
• 응답 post.status ∈ scheduled|published|draft|pending — 기대값을 ASSERT. scheduled를 기대했는데 published면 이미 라이브 — 즉시 유저에게 보고.
• YouTube platformSpecificData: {title(≤100), visibility, madeForKids}; 커스텀 썸네일은 mediaItems[].thumbnail (<2MB, ≥640px, 일반 영상만 — Shorts는 불가; ≤3분 세로 영상은 자동으로 Short 분류).
• Instagram: {contentType: "reels", shareToFeed: true}; 릴스 9:16, 3–90s, ≤300MB, H.264. 릴스 커버는 발행 전에 첨부 — 발행 후 API 변경 불가.
• IG는 YouTube보다 1–3분 늦게 게시된다 — 정상이지 실패가 아니다.

C. 수정 · 즉시 발행 · 확인

• 재예약/수정: PUT /posts/{id} (PATCH는 405).
• "지금 올려줘": PUT으로 scheduledFor = now+2분 (과거 시각은 거부될 수 있음) → 30초 간격 GET 폴링 → 전 플랫폼 published 확인 → platformPostUrl 보고.
• 타임아웃 ≠ 실패: 대용량 POST는 클라이언트 타임아웃 후에도 서버에서 성공해 있을 수 있다. 애매하면 GET /v1/posts?limit=10에서 내 콘텐츠를 먼저 찾고, 진짜 없을 때만 재시도. 블라인드 재시도 = 중복 게시.