revkit/docs/instructions/android/http_headers_cookies.md

Netflix Android 9.57.0 — HTTP ヘッダー & Cookie リファレンス

Frida hook_headers.js (Cronet フック) により 1,274 リクエストをキャプチャして整理。

---

通信経路

経路	用途	ライブラリ
Cronet (メイン)	通常 HTTP (API, config, GraphQL, logs)	org.chromium.net.impl.CronetUrlRequest
OkHttp	WebSocket 接続のみ	okhttp3.internal.connection.RealCall

---

Cookie 一覧

Cookie 名	出現頻度	説明
nfvdid	1,271/1,274	Netflix Virtual Device ID。Base64url エンコードされたバイナリ
flwssn	1,271/1,274	Flow Session ID。UUID v4 形式
gsid	1,166/1,274	GraphQL Session ID。UUID v4 形式。ログイン後に付与
NetflixId	105/1,274	ユーザー認証 Cookie。未ログイン時は送信されない
SecureNetflixId	105/1,274	HMAC 署名付き認証 Cookie。NetflixId と常にペア

Cookie 値の構造

nfvdid=BQFmAAEBEEPj84LzHGpQ_ldxaVuQv8tgIBE9VAe3w-WeF5En4w5goMB6eLYVXqxblfzh23QC62wkeecr...
  → Base64url エンコードされたバイナリトークン

flwssn=183a999e-9ce9-4f29-ac9f-3f8b3982c817
  → UUID v4 (セッション単位で変化)

gsid=d4779eb6-16d4-4179-89af-a069f7f1fc07
  → UUID v4 (ログイン後に生成)

NetflixId=v%3D3%26ct%3DBgjHlOvcAxKoAo...
  → URL エンコード済み。デコードすると: v=3&ct=<base64url>&pg=<profile_guid>&ch=<checksum>

SecureNetflixId=v%3D3%26mac%3DAQEAEQABABTPJ-U_...%26dt%3D1773402757629
  → URL エンコード済み。デコードすると: v=3&mac=<hmac>&dt=<epoch_ms>

Cookie の送信パターン

エンドポイント種別	nfvdid	flwssn	gsid	NetflixId	SecureNetflixId
appboot	-	-	-	-	-
config (GET, 未ログイン)	✓	✓	-	✓	✓
graphql (ftl, 未ログイン)	✓	✓	-	✓	✓
pathEvaluator	✓	✓	-	✓	✓
cl/2 (ログ)	✓	✓	-	✓	✓
graphql (MSL 暗号化)	✓	✓	✓	-	-
config (POST, MSL)	✓	✓	✓	-	-
logblob	✓	✓	✓	-	-

パターン: MSL 暗号化 (Content-Encoding: msl_v1) リクエストでは NetflixId/SecureNetflixId が省略され、代わりに gsid が付与される。平文リクエストではその逆。

---

ヘッダー一覧

共通ヘッダー (ほぼ全リクエストに存在)

ヘッダー	値の例	説明
X-Netflix.Request.Client.Context	{"appState":"background","appView":"login"}	アプリ状態の JSON
X-Netflix.zuul.brotli.allowed	true	Brotli 圧縮許可
X-Netflix.Request.Attempt	1	リトライ番号
X-Netflix.Request.Id	afa97a02e3a349807ca65a0517e386c7	リクエスト一意 ID (hex)
X-Netflix.Client.Request.Name	FetchConfigDataWebRequest	リクエスト種別名

デバイス識別ヘッダー

ヘッダー	値	説明
X-Netflix.clientType	samurai	クライアント種別 (Android = samurai)
X-Netflix.deviceMemoryLevel	HIGH	メモリレベル
X-Netflix.appVer	9.57.0	アプリバージョン
X-Netflix.esnPrefix	NFANDROID1-PRV-P-L3-	ESN プレフィックス (PRV)
X-Netflix.androidApi	34	Android API レベル
X-Netflix.esn	NFANDROID1-PXA-P-L3-GOOGLPIXEL=4A==5G=-22594-...	フル PXA ESN
X-Netflix.deviceFormFactor	PHONE	フォームファクタ

セッション・コンテキストヘッダー

ヘッダー	値の例	説明
X-Netflix.session.id	1773552898264781980	セッション ID (数値)
x-netflix.client.current-profile-guid	ZEULH5S2GNGCRAABCSG6J2EGGA	現在のプロファイル GUID
X-Netflix.request.uuid	UUID v4	リクエスト UUID
X-Netflix.request.toplevel.uuid	UUID v4	トップレベルリクエスト UUID
X-Netflix.tracing.cl.userActionId	UUID v4	ユーザーアクション追跡 ID

コンテキストヘッダー (x-netflix.context.*)

ヘッダー	値	説明
x-netflix.context.os-version	34	OS バージョン
x-netflix.context.app-version	9.57.0	アプリバージョン
x-netflix.context.locales	en-US or en-JP	ロケール
x-netflix.context.ui-flavor	android	UI プラットフォーム
x-netflix.context.form-factor	phone	デバイス形状
x-netflix.context.android.installer-source	com.android.vending	インストール元
x-netflix.context.operation-name	CurrentCountryQuery	GraphQL オペレーション名
x-netflix.context.feature-capabilities	supportsStudioBranding	機能フラグ
x-netflix.context.hawkins-version	5.13.0	Hawkins バージョン

MSL 関連ヘッダー

ヘッダー	値	説明
Content-Encoding	msl_v1	MSL 暗号化ボディ
x-netflix.client.android.mslrequest	true	MSL リクエストフラグ
x-netflix.client.request.transport	http	トランスポート種別

その他

ヘッダー	値	説明
X-Netflix-Internal-Volley-Priority	NORMAL / HIGH / null	Volley 優先度
x-netflix.playback.main-content-viewable-id	81650338	再生中コンテンツ ID
X-Netflix.Request.Routing	JSON	ルーティング設定
X-Netflix.Request.NqTracking	リクエスト名	NQ 追跡用
debugRequest	true	デバッグフラグ (ログ系)
x-netflix.request.clcs.bucket	high	CLCS バケット

---

エンドポイント一覧

1. appboot (POST)

POST https://android14.appboot.netflix.com/appboot/NFANDROID1-PRV-P-L3-?keyVersion=1&suspended=false
Content-Type: application/x-www-form-urlencoded
Cookies: なし

アプリ起動時の初期化。ESN プレフィックスが URL パスに含まれる。Cookie なし。

2. config (GET)

GET https://android14.prod.ftl.netflix.com/nq/androidui/samurai/v1/config?method=get&path=...
Cookies: nfvdid, flwssn, NetflixId, SecureNetflixId

デバイス設定・機能フラグ取得。URL クエリに大量のデバイス情報を含む。

3. samurai API (POST)

POST https://android14.prod.ftl.netflix.com/nq/androidui/samurai/~9.0.0/api?method=get&...
Cookies: nfvdid, flwssn (+ NetflixId/SecureNetflixId or gsid)

メイン API エンドポイント。再生マニフェスト取得 (licensedManifest) 等。

4. GraphQL — ftl (POST)

POST https://android14.prod.ftl.netflix.com/graphql
Content-Type: application/json
Cookies: nfvdid, flwssn, NetflixId, SecureNetflixId

GraphQL API (平文)。CurrentCountryQuery 等。

5. GraphQL — cloud (POST, MSL)

POST https://android.prod.cloud.netflix.com/graphql
Content-Encoding: msl_v1
Content-Type: application/json
Cookies: flwssn, nfvdid, gsid

GraphQL API (MSL 暗号化)。InterstitialHook, AccountQuery 等。

6. pathEvaluator (POST)

POST https://android.prod.cloud.netflix.com/nq/aui/endpoint/^1.0.0-mobile/pathEvaluator
Cookies: nfvdid, flwssn, NetflixId, SecureNetflixId

UI パス評価。Falcor ベースのデータフェッチ。

7. cl/2 ログ (POST)

POST https://android14.logs.netflix.com/log/android/cl/2?TAG=LOG_CLV2
Content-Type: application/json
Cookies: nfvdid, flwssn, NetflixId, SecureNetflixId

クライアントログ送信 (平文)。

8. logblob (POST, MSL)

POST https://android14.logs.netflix.com/log/android/logblob/1
Content-Encoding: msl_v1
Cookies: flwssn, nfvdid, gsid

バイナリログ送信 (MSL 暗号化)。

---

cURL 例

config 取得 (全ヘッダー付き)

curl -X GET \
  "https://android14.prod.ftl.netflix.com/nq/androidui/samurai/v1/config?method=get&responseFormat=json" \
  -H "X-Netflix.clientType: samurai" \
  -H "X-Netflix.appVer: 9.57.0" \
  -H "X-Netflix.esnPrefix: NFANDROID1-PRV-P-L3-" \
  -H "X-Netflix.esn: NFANDROID1-PXA-P-L3-GOOGLPIXEL=4A==5G=-22594-..." \
  -H "X-Netflix.androidApi: 34" \
  -H "X-Netflix.deviceFormFactor: PHONE" \
  -H "X-Netflix.deviceMemoryLevel: HIGH" \
  -H "X-Netflix.session.id: 7994808" \
  -H "X-Netflix.zuul.brotli.allowed: true" \
  -H "X-Netflix.Request.Attempt: 1" \
  -H "X-Netflix.Request.Id: $(uuidgen | tr -d '-')" \
  -H "X-Netflix.Client.Request.Name: FetchConfigDataWebRequest" \
  -H "X-Netflix.Request.Client.Context: {\"appState\":\"foreground\",\"appView\":\"home\"}" \
  -H "x-netflix.context.os-version: 34" \
  -H "x-netflix.context.app-version: 9.57.0" \
  -H "x-netflix.context.locales: en-US" \
  -H "x-netflix.context.ui-flavor: android" \
  -H "x-netflix.context.form-factor: phone" \
  -H "x-netflix.context.android.installer-source: com.android.vending" \
  -b "nfvdid=<NFVDID>; flwssn=<UUID>; NetflixId=<NETFLIX_ID>; SecureNetflixId=<SECURE_NETFLIX_ID>"

GraphQL (MSL 暗号化)

curl -X POST \
  "https://android.prod.cloud.netflix.com/graphql" \
  -H "Content-Type: application/json" \
  -H "Content-Encoding: msl_v1" \
  -H "X-Netflix.clientType: samurai" \
  -H "X-Netflix.appVer: 9.57.0" \
  -H "X-Netflix.esnPrefix: NFANDROID1-PRV-P-L3-" \
  -H "X-Netflix.androidApi: 34" \
  -H "X-Netflix.deviceFormFactor: PHONE" \
  -H "X-Netflix.deviceMemoryLevel: HIGH" \
  -H "X-Netflix.zuul.brotli.allowed: true" \
  -H "x-netflix.client.android.mslrequest: true" \
  -H "x-netflix.context.operation-name: AccountQuery" \
  -H "X-Netflix.Client.Request.Name: AccountQuery" \
  -H "X-Netflix.Request.Attempt: 1" \
  -H "X-Netflix.Request.Id: $(uuidgen | tr -d '-')" \
  -H "accept: multipart/mixed;deferSpec=20220824, application/graphql-response+json, application/json" \
  -b "flwssn=<UUID>; nfvdid=<NFVDID>; gsid=<UUID>" \
  -d '<MSL_ENCRYPTED_BODY>'

---

ESN の送信箇所 (HTTP ヘッダー経由)

ヘッダー	値の種類	出現頻度
X-Netflix.esn	フル PXA ESN	707/1,274
X-Netflix.esnPrefix	PRV プレフィックス (NFANDROID1-PRV-P-L3-)	1,210/1,274
URL パス (appboot)	PRV プレフィックス	appboot のみ

注: X-Netflix.esn は PXA (Proxy) ESN が送られる。PRV (Private) ESN はプレフィックスのみ。