sangtao.ai
API key

Đăng bài

Tài khoản của nhóm

Các tài khoản mạng xã hội đang kết nối trong một nhóm.

GEThttps://api.sangtao.ai/v2/publishing/teams/{teamId}/accounts

Xác thực

  • X-Api-Keystring · headerbắt buộc

    API key của bạn, tạo ở trang API key trong tài khoản.

Tham số đường dẫn

  • teamIdstringbắt buộc

    teamId trong đường dẫn.

Các tài khoản đang kết nối của nhóm, được làm mới từ các nền tảng trước khi trả về — mới nhất trước. Tài khoản đã ngắt kết nối không có trong danh sách.

Response

  • idstringbắt buộc

    Mã tài khoản, sa_…. Coi là chuỗi mờ, đừng so sánh hay tính toán

  • platformstringbắt buộc

    Nền tảng

    Giá trị có thể:TikTokYouTubeInstagramFacebookThreadsTwitter

  • displayNamestring | null

    Tên hiển thị của tài khoản

  • usernamestring | null

    Username của tài khoản

  • ownerDisplayNamestring | null

    Tên người đã kết nối tài khoản

  • avatarUrlstring | null

    URL ảnh đại diện

  • channelIdstring | null

    Page hoặc kênh mà bài sẽ đăng vào (tài khoản Facebook có nhiều Page, YouTube có nhiều kênh)

  • channelNamestring | null

    Tên Page hoặc kênh đó

  • pageobject | null

    Trang hoặc kênh bài sẽ lên. null nếu nền tảng không có trang để chọn

    Hiện thuộc tính con

    • idstringbắt buộc

      Mã trên nền tảng (như channelId)

    • namestringbắt buộc

      Tên trang

    • avatarUrlstring | null

      Ảnh đại diện của trang

  • needsAttentionbooleanbắt buộc

    true: trang bị đổi hoặc mất quyền mà bạn không chọn — đăng lên tài khoản này bị từ chối (409 ACCOUNT_NEEDS_ATTENTION) tới khi chọn lại trang trên sangtao.ai

  • attentionReasonstring | null

    Lý do. null khi không có vấn đề

    Giá trị có thể:CHANNEL_CHANGEDCHANNEL_LOST

  • expectedChannelobject | null

    Trang bạn đã chọn, { id, name } — chỉ có khi needsAttention

  • actualChannelobject | null

    Trang nền tảng đã tự đổi sang, { id, name } — chỉ với CHANNEL_CHANGED

  • attentionAtstring | null

    Lúc phát hiện (ISO 8601, UTC)

  • isConnectedbooleanbắt buộc

    Luôn là true — chỉ liệt kê tài khoản đang kết nối

  • connectedAtstringbắt buộc

    Thời điểm kết nối (ISO 8601, UTC)

  • disconnectedAtstring | null

    Thời điểm ngắt kết nối gần nhất, nếu có

Mã lỗi

MãerrorCodeKhi nào
404TEAM_NOT_FOUNDKhông có nhóm nào của bạn với teamId này
GET/publishing/teams/{teamId}/accounts
curl "https://api.sangtao.ai/v2/publishing/teams/3fa85f64-5717-4562-b3fc-2c963f66afa6/accounts" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": [
    {
      "id": "sa_7mR2xLq5D",
      "platform": "Facebook",
      "displayName": "Your Page",
      "username": "yourpage",
      "ownerDisplayName": "Jane Doe",
      "avatarUrl": "https://cdn.example.com/avatar.jpg",
      "channelId": "1234567890",
      "channelName": "Your Page",
      "page": {
        "id": "1234567890",
        "name": "Your Page",
        "avatarUrl": "https://cdn.example.com/page.jpg"
      },
      "needsAttention": false,
      "attentionReason": null,
      "expectedChannel": null,
      "actualChannel": null,
      "attentionAt": null,
      "isConnected": true,
      "connectedAt": "2026-11-01T10:05:00Z",
      "disconnectedAt": null
    }
  ]
}