문서

채널 연결

소셜 계정을 연결하고, 발행에 쓸 계정 id를 받는 방법이에요.

채널 연결은 API로 하지 않고 대시보드에서 해요. 채널마다 뜨는 OAuth 로그인 화면을 사람이 직접 보고 허용해야 하기 때문이에요.

연결이 끝나면 그 계정이 GET /v1/accounts 목록에 id와 함께 나와요. 글을 올릴 때 넣는 값이 이 id예요.

GET /v1/accounts

연결된 계정 목록과 각 계정의 id를 돌려줘요.

{
  "data": [
    {
      "id": "acc_01H...",
      "platform": "threads",
      "handle": "posendy_official",
      "displayName": "posendy",
      "status": "active"
    }
  ]
}

// 연결된 계정이 없으면 어디서 연결하는지 같이 와요. 계정이 있으면 next 칸은 없어요
{
  "data": [],
  "next": {
    "action": "connect_channel",
    "url": "https://posendy.com/en/dashboard/connections",
    "message": "No channel is connected yet. Open that link, connect one, then try again."
  }
}

채널 로그인은 60일마다 만료돼요. 포샌디가 만료 전에 알아서 갱신해요. 갱신에 실패하면 그 계정은 expired로 바뀌고, 그 계정으로 가는 발행은 올리는 도중에 실패하지 않고 시작 전에 거절돼요.

자주 묻는 것

API로 채널을 연결할 수 있어요?

안 돼요. 일부러 막아 뒀어요. 채널 로그인 화면은 사람이 직접 봐야 해서, 연결은 대시보드에서 하고 API로는 연결된 결과만 읽어요.

채널이 expired로 보여요

그 계정의 로그인 갱신이 실패한 상태예요. 대시보드의 연결 화면에서 같은 계정을 다시 연결하면 active로 돌아와요. expired 상태에서는 발행이 시작 전에 거절되니까 글이 반만 올라가는 일은 없어요.

지금 연결할 수 있는 채널은 무엇이에요?

지금 6개, 준비 중 6개예요.

상태채널
지금 지원Threads, Instagram, YouTube, Facebook, Telegram, 네이버 블로그
준비 중TikTok, 네이버 클립, Bluesky, Pinterest, Discord, Ghost

준비 중 채널로 글을 보내면 조용히 버리지 않고 platform_not_available로 거절해요. 채널별 제한은 플랫폼에서 확인하고, 다음은 발행으로 넘어가요.