チャネル
TikTok 認証
TikTok は QR ログインと auth_mode=session による Cookie インポートに対応しています。アカウント作成時に認証方式を選択してください。
認可方式を選ぶ
qrcode
TikTok QR 認証は標準アカウント / QR API を使い、初回レスポンスに QR URL がない場合があります。
- 1. POST /v1/accounts に provider=tiktok、auth_mode=qrcode を指定。
- 2. POST /v1/accounts/{account_id}/auth/qr/start で TikTok ブラウザセッションを開始。
- 3. account.auth.required を待つか POST /v1/accounts/{account_id}/auth/qr/check をポーリングします。
- 4. account.auth.succeeded 後に runtime_status を確認し、必要な場合だけ runtime を開始します。
session
TikTok は QR ログインと auth_mode=session による Cookie インポートに対応しています。アカウント作成時に認証方式を選択してください。
- 1. 空き容量のあるリージョンで provider=tiktok、auth_mode=session を指定して作成します。残高払いのアカウントは CREATE 操作が SUCCEEDED になってから認証してください。
- 2. POST /v1/accounts/{account_id}/auth/session に tiktok.cookies を送信します。各 Cookie には name、value、domain、path が必要です。1~128 件、JSON 全体で 65536 バイト以内とし、トップレベルのフィールドは tiktok のみにしてください。
- 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 の保証でもありません。