API リファレンス

チャネル

TikTok 認証

TikTok は QR ログインと auth_mode=session による Cookie インポートに対応しています。アカウント作成時に認証方式を選択してください。

認可方式を選ぶ

qrcode

TikTok QR 認証は標準アカウント / QR API を使い、初回レスポンスに QR URL がない場合があります。

  1. 1. POST /v1/accounts に provider=tiktok、auth_mode=qrcode を指定。
  2. 2. POST /v1/accounts/{account_id}/auth/qr/start で TikTok ブラウザセッションを開始。
  3. 3. account.auth.required を待つか POST /v1/accounts/{account_id}/auth/qr/check をポーリングします。
  4. 4. account.auth.succeeded 後に runtime_status を確認し、必要な場合だけ runtime を開始します。

session

TikTok は QR ログインと auth_mode=session による Cookie インポートに対応しています。アカウント作成時に認証方式を選択してください。

  1. 1. 空き容量のあるリージョンで provider=tiktok、auth_mode=session を指定して作成します。残高払いのアカウントは CREATE 操作が SUCCEEDED になってから認証してください。
  2. 2. POST /v1/accounts/{account_id}/auth/session に tiktok.cookies を送信します。各 Cookie には name、value、domain、path が必要です。1~128 件、JSON 全体で 65536 バイト以内とし、トップレベルのフィールドは tiktok のみにしてください。
  3. 3. インポートするとログインを開始します。pending の間は GET /v1/accounts/{account_id}/auth または POST /v1/accounts/{account_id}/runtime/refresh で確認し、authorized かつ running になってから業務 API を利用してください。HTTP 200 や Cookie 形式の検証成功だけでは認証完了を意味しません。

Verify the signature

TikTok · session

curl -X POST "https://api.unifyport.ai/v1/accounts/{account_id}/auth/session" \
  -H "X-Api-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "tiktok": {
    "cookies": [{ "name": "sessionid", "value": "<COOKIE_VALUE>", "domain": ".tiktok.com", "path": "/" }]
  }
}'

注記

  • 最初の qr/start は QR URL を省略する場合があります。Webhook と qr/check を併用してください。
  • QR と session は同じアカウントで切り替えられません。session では QR や確認コードの追加操作に対応していません。既存ログインの置換は保証されず、任意の互換フィールド user_id は本人確認に使われません。
  • 現在のソースは private/user 会話だけを message.received に変換します。グループ、ACK、notice、comment は公開イベントではなく、実アカウント E2E の保証でもありません。