Open Perlica API
OpenapiApiV1Characters

查询角色列表

GET
/api/v1/characters

Authorization

bearerAuth
AuthorizationBearer <token>

需要凭证时,请使用 Bearer token。

In: header

Query Parameters

q?string

模糊查询关键词。

page?integer

页码,小于 1 时按 1 处理。

Default1
Range1 <= value
pageSize?integer

每页数量,服务端会限制在 1 到 maxPageSize 之间。

Default50
Range1 <= value

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://openapi.perlica.tech/api/v1/characters"
{
  "data": [
    {
      "id": "string",
      "name": "string",
      "engName": "string",
      "phoneticName": "string",
      "rarity": 0,
      "profession": "string",
      "weaponType": "string",
      "weaponTypeName": "string",
      "department": "string",
      "mainAttrType": "string",
      "subAttrType": "string",
      "sortOrder": 0,
      "battleTagIds": [
        "string"
      ],
      "attributes": [
        {
          "breakStage": 0,
          "attrs": {
            "property1": 0,
            "property2": 0
          }
        }
      ],
      "profileRecords": [
        {
          "id": "string",
          "title": "string",
          "desc": "string",
          "unlockType": "string",
          "unlockValue": 0
        }
      ]
    }
  ],
  "page": 0,
  "pageSize": 0,
  "total": 0
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}

© 2026 Origin Technology 保留所有权利。

Perlica 使用的游戏图片、动画、音频、文本原文,所涉及的公司名称、商标、产品等均为其各自所有者的资产,仅供识别。

部分源数据由 AKEData.Top(渚汐奏梦)提供,并经 Perlica 整理、转换与二次处理;处理结果仅用于信息展示与资料索引。