Skport / Gryphline API 文件

部分遊戲術語（精英化=Promotion、潛能/命座=Potential、術師=Caster、理智=Sanity 等）已對照 Arknights: Endfield 官方英文版查證。標註「英譯未查證」的詞條（謎質、黑匣子、維修靈感點、總控中樞、光榮之路等）為合理推測翻譯，並非官方確認用詞，使用前建議自行核對。

Domains

Domain	用途
`as.gryphline.com`	帳號認證、OAuth
`ef-webview.gryphline.com`	抽卡紀錄、卡池 metadata
`web-api.skport.com`	ACCOUNT_TOKEN 刷新
`zonai.skport.com`	所有遊戲資料 API
`static.skport.com`	靜態資源（圖片 CDN）
`game.skport.com`	遊戲內工具頁面

認證流程

0. 帳號密碼登入（可選）

POST as.gryphline.com/user/auth/v1/token_by_email_password
Header: x-language: zh-tw
Body: { email, password, captchaToken }
→ ACCOUNT_TOKEN

0.5. 驗證 ACCOUNT_TOKEN 有效性

GET as.gryphline.com/user/info/v1/basic
Header: Authorization: Bearer {ACCOUNT_TOKEN}
→ 確認 token 有效（basicUser 資料）

1. OAuth Grant

POST as.gryphline.com/user/oauth2/v2/grant
Body: { token: ACCOUNT_TOKEN, appCode: "6eb76d4e13aa36e6", type: 0 }
→ code

2. 生成 cred

POST zonai.skport.com/web/v1/user/auth/generate_cred_by_code
Body: { kind: 1, code }
→ cred

3. 刷新取得 salt

GET zonai.skport.com/web/v1/auth/refresh
Header: cred
→ salt（用於所有需要簽名的 API）

簽名算法

V2（主要端點用）

headerJson = { platform:"3", timestamp:"...", dId:"", vName:"1.0.0" }
sign = MD5( HEX( HMAC-SHA256( path + body + timestamp + headerJson, salt ) ) )

V1（輕量端點用）

sign = MD5( path + query + timestamp + salt )

自動選擇規則：以下 path 使用 V2，其餘使用 V1：

/api/v1/game/player/binding
/api/v1/game/endfield/card/detail
/web/v1/wiki/*
/web/v1/game/endfield/enums
/web/v1/game/endfield/attendance*
/web/v2/*

請求類型	body 值
GET（無 params）	空字串 `""`
GET（有 query params）	query string，例如 `roleId=xxx&serverId=yyy`
POST	JSON 字串

標準 Headers

Content-Type: application/json
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36
sec-ch-ua: "Google Chrome";v="145", "Not-A.Brand";v="99"
sec-ch-ua-mobile: ?0
sec-ch-ua-platform: "Windows"
sec-fetch-dest: empty
sec-fetch-mode: cors
sec-fetch-site: same-site        # gryphline 域名改為 cross-site
Origin: https://game.skport.com
Referer: https://game.skport.com/
sk-language: zh-tw               # gryphline 域名改用 x-language: zh-tw

遊戲 API（zonai.skport.com）

取得綁定角色列表

GET zonai.skport.com/api/v1/game/player/binding
簽名: 需要（V2，body=""）

回傳結構

{
  "data": {
    "list": [
      {
        "appCode": "endfield",
        "bindingList": [
          {
            "defaultRole": {
              "roleId": "...",
              "serverId": "...",
              "nickname": "...",
              "level": 0,
              "serverName": "..."
            },
            "roles": []
          }
        ]
      }
    ]
  }
}

gameRole 格式："3_{roleId}_{serverId}"

取得完整遊戲資料卡

GET zonai.skport.com/api/v1/game/endfield/card/detail
Params: roleId, serverId（uid 可選）
Header: sk-game-role = "3_{roleId}_{serverId}"
簽名: 需要（V2，body = query string）

回傳結構 detail

detail
├── base
├── chars[]
├── achieve
├── spaceShip
│   └── rooms[]
├── domain[]
├── dungeon
├── bpSystem
├── dailyMission
├── config
└── quickaccess[]

base 欄位

欄位	說明
`roleId`	UID
`name`	玩家名稱
`serverName`	服務器名稱
`level`	權限等階
`worldLevel`	探索等級
`exp`	當前經驗值
`gender`	主角性別（1=男 2=女）
`avatarUrl`	頭像圖片 URL
`mainMission.description`	使命紀事文字
`charNum`	幹員數量
`weaponNum`	武器數量
`docNum`	文檔數量
`createTime`	甦醒日（timestamp）
`lastLoginTime`	最後登入（timestamp）
`saveTime`	資料儲存時間（timestamp）

dungeon 欄位

欄位	說明
`curStamina`	當前理智
`maxStamina`	最大理智
`maxTs`	理智滿溢時間點（timestamp）

bpSystem 欄位

欄位	說明
`curLevel`	通行證當前等級
`maxLevel`	通行證最大等級

dailyMission 欄位

欄位	說明
`dailyActivation`	每日任務當前進度
`maxDailyActivation`	每日任務上限

achieve 欄位

欄位	說明
`count`	光榮之路數量（英譯未查證，暫譯 Glory Road）

spaceShip.rooms[] 欄位

欄位	說明
`type`	房間類型（`0` = 總控中樞，英譯未查證）
`level`	房間等級

chars[] 欄位

chars[]
├── charData
│   ├── id
│   ├── name
│   ├── avatarSqUrl        # 方形頭像
│   ├── avatarRtUrl        # 圓形頭像
│   ├── illustrationUrl    # 立繪
│   ├── rarity.key         # rarity_6 / rarity_5 / rarity_4 / rarity_3
│   ├── profession.value   # 官方六大職業：先鋒/近衛/重裝/術師/狙擊/醫療
│   │                      # → Vanguard/Guard/Defender/Caster/Sniper/Medic
│   │                      # （請依實際 API 回傳字串核對）
│   ├── property.value     # 元素屬性
│   ├── weaponType.value   # 武器類型
│   ├── skills[]
│   │   ├── id, name
│   │   ├── type.key       # skill_type_normal_attack / normal_skill / combo_skill / ultimate_skill
│   │   ├── iconUrl
│   │   └── desc
│   ├── labelType          # label_type_up（限定）等
│   └── tags[]
├── id
├── level
├── evolvePhase            # 精英化階段（0–4），官方英譯為 Promotion
├── potentialLevel         # 潛能（0–5）
├── userSkills{}           # { skillId: { level, maxLevel } }
├── bodyEquip              # 護甲
├── armEquip               # 護手
├── firstAccessory         # 配件1
├── secondAccessory        # 配件2
├── tacticalItem           # 戰術道具
├── weapon
│   ├── weaponData{ id, name, iconUrl, rarity, type, skills[], labelType }
│   ├── level
│   ├── refineLevel        # 武器潛能（0–5）
│   ├── breakthroughLevel  # 武器突破（0–4）
│   └── gem{ id, icon }
├── gender
└── ownTs                  # 獲得時間（timestamp）

domain[] 欄位

domain[]
├── name                   # 地區名稱
├── level                  # 地區等級
├── settlements[]
│   ├── name               # 據點名稱
│   └── level               # 據點等級
└── collections[]
    ├── puzzleCount        # 謎質（英譯未查證，暫譯 Enigma Matter）
    ├── trchestCount       # 儲藏箱（英譯未查證，暫譯 Storage Chest）
    ├── pieceCount         # 維修靈感點（英譯未查證，暫譯 Repair Inspiration Point）
    └── blackboxCount      # 黑匣子（英譯未查證，暫譯 Black Box）

quickaccess[] 欄位

名稱	說明
養成建議	`game.skport.com/tools/endfield/list?routeId=1`
編隊推薦	`game.skport.com/tools/endfield/list?routeId=0`
地圖工具	`game.skport.com/map/endfield`

取得遊戲枚舉常數

GET zonai.skport.com/web/v1/game/endfield/enums
簽名: 需要（V2，body=""）

回傳職業、屬性、稀有度、技能類型等所有遊戲枚舉，可用於替換 rarity.key / profession.value 等為顯示文字。

每日簽到

以下三個端點均需：

Header: sk-game-role: 3_{roleId}_{serverId}

Header: Cookie: {已登入 cookie}

簽名: 需要（V2）

GET  zonai.skport.com/web/v1/game/endfield/attendance
→ 取得本月簽到日曆（已簽天數、獎勵清單）

POST zonai.skport.com/web/v1/game/endfield/attendance
→ 執行當日簽到（body = "{}"）

GET  zonai.skport.com/web/v1/game/endfield/attendance/records
→ 取得歷史簽到紀錄

Wiki 資料庫

GET zonai.skport.com/web/v1/wiki/char-pool
→ 當前角色卡池 metadata（含 up6_name）

GET zonai.skport.com/web/v1/wiki/weapon-pool
→ 武器卡池 metadata

GET zonai.skport.com/web/v1/wiki/item/catalog
→ 道具資料庫（全清單）

GET zonai.skport.com/web/v1/wiki/item/info?id={item_id}
→ 特定道具詳情

取得用戶基本資料

GET zonai.skport.com/web/v2/user
簽名: 需要（V2，body=""）

回傳結構

{
  user
  ├── basicUser
  │   ├── id               # 平台 UID
  │   ├── nickname         # 暱稱
  │   ├── profile          # 自介（可能為空字串）
  │   ├── avatar           # 頭像 URL
  │   ├── avatarCode
  │   ├── gender           # 0=未設定
  │   ├── birthday         # timestamp
  │   ├── status
  │   ├── identity
  │   ├── createdAt        # 帳號建立時間
  │   └── latestLoginAt    # 最後登入時間
  ├── pendant
  │   ├── id
  │   ├── iconUrl
  │   ├── title            # 頭像框名稱
  │   └── description
  └── background           # 可能為 null
  userRts
  ├── follow               # 追蹤數
  ├── fans                 # 粉絲數
  └── liked                # 獲讚數
  userSanctionList[]
  userInfoApply{}
  moderator{}
}

抽卡紀錄 API（ef-webview.gryphline.com）

此組 API 使用遊戲客戶端匯出的 URL 內建 token，不走 cred/salt 簽名流程。

URL 通用參數

參數	說明
`token` / `u8_token`	從遊戲客戶端匯出的認證 token
`server_id` / `server`	伺服器 ID（Global = `2`）
`lang`	語言（預設 `en-us`）

取得卡池 metadata

GET ef-webview.gryphline.com/api/content
Params: token, server_id, lang
→ 卡池資訊（含 up6_name、up6_item_name，可用於 featured 偵測）

角色抽卡紀錄

GET ef-webview.gryphline.com/api/record/char
Params: token, server_id, lang, seq_id（分頁游標，首次傳 0）
→ 角色抽卡紀錄列表

武器卡池列表

GET ef-webview.gryphline.com/api/record/weapon/pool
Params: token, server_id, lang
→ 所有武器卡池清單（取得各池的 pool_id）

武器抽卡紀錄

GET ef-webview.gryphline.com/api/record/weapon
Params: token, server_id, pool_id, lang, seq_id（分頁游標）
→ 指定武器卡池的抽卡紀錄

Pity 分組規則

類型	Pity Group
限定 / 特別卡池	`SpecialShared`（所有限定池共享）
新手卡池	`Beginner`（獨立計算）
常駐池	依 `poolId` 各自獨立

遊戲術語對照

終末地術語	欄位	說明	上限
精英化（英譯：Promotion）	`evolvePhase`	幹員突破	E4
潛能（英譯：Potential）	`potentialLevel`	幹員命座	5
武器潛能（英譯：Weapon Potential）	`refineLevel`	武器命座	5
武器突破（英譯：Weapon Breakthrough）	`breakthroughLevel`	武器突破階段	4
技能：普攻	`skill_type_normal_attack`	—	—
技能：技能	`normal_skill`	—	—
技能：聯合技	`combo_skill`	—	—
技能：終結技	`ultimate_skill`	—	—
限定幹員	`labelType: label_type_up`	—	—

官方六大職業中英對照（已查證）：

中文	English
先鋒	Vanguard
近衛	Guard
重裝	Defender
術師	Caster
狙擊	Sniper
醫療	Medic

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
README.md		README.md
README_EN.md		README_EN.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Skport / Gryphline API 文件

Domains

認證流程

0. 帳號密碼登入（可選）

0.5. 驗證 ACCOUNT_TOKEN 有效性

1. OAuth Grant

2. 生成 cred

3. 刷新取得 salt

簽名算法

V2（主要端點用）

V1（輕量端點用）

標準 Headers

遊戲 API（zonai.skport.com）

取得綁定角色列表

取得完整遊戲資料卡

取得遊戲枚舉常數

每日簽到

Wiki 資料庫

取得用戶基本資料

抽卡紀錄 API（ef-webview.gryphline.com）

取得卡池 metadata

角色抽卡紀錄

武器卡池列表

武器抽卡紀錄

遊戲術語對照

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

Skport / Gryphline API 文件

Domains

認證流程

0. 帳號密碼登入（可選）

0.5. 驗證 ACCOUNT_TOKEN 有效性

1. OAuth Grant

2. 生成 cred

3. 刷新取得 salt

簽名算法

V2（主要端點用）

V1（輕量端點用）

標準 Headers

遊戲 API（zonai.skport.com）

取得綁定角色列表

取得完整遊戲資料卡

取得遊戲枚舉常數

每日簽到

Wiki 資料庫

取得用戶基本資料

抽卡紀錄 API（ef-webview.gryphline.com）

取得卡池 metadata

角色抽卡紀錄

武器卡池列表

武器抽卡紀錄

遊戲術語對照

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Packages