添加友链

1. 注册账号

首先，您需要在 chat.quetzalsidera.me 上注册一个账号。

请妥善保存您的邮箱和密码，在后续步骤中需要使用它们来获取API令牌。

2. 获取API令牌

使用您在步骤1中注册的邮箱和密码，调用"申请AuthToken"API获取API令牌。由于涉及邮箱与密码，请确保使用HTTPS协议。

API请求示例：

curl "https://api.quetzalsidera.me/v1/authToken?email=example@example.com&password=123456"

成功响应示例：

{
  "status": 0,
  "message": "Ok",
  "data": {
    "userGuid": "4254bf69-a6d2-4602-872d-1d1546b25869",
    "authToken": "44cc78fb-c2cc-4a37-bab4-72c4023e3ae0",
    "createTimestamp": 1760614727,
    "isAdmin": false
  }
}

注意：请妥善保存响应中的 userGuid和authToken，它们将在后续步骤中分别作为API请求报文首部中的 Authorization和AuthToken。

3. 添加好友卡片

使用步骤2中获得的API令牌，调用"添加好友卡片"API将您的卡片内容添加到审核列表。

好友卡片展示效果示例

Json请求体

{
  "link": "https://example.com/friend-profile",  // 目标链接
  "pictureLink": "https://example.com/images/profile-pic.jpg", // 头像Url
  "title": {
    "zhCn": "标题",       //卡片标题 简体中文
    "enUs": "title",     //卡片标题 英文（美国）
    "zhHk": "標題",       //卡片标题 繁体中文（香港）
    "zhTw": "標題",       //卡片标题 繁体中文（台湾）
    "enGb": "title",     //卡片标题 英文（英国）
    "jaJp": "タイトル"    //卡片标题 日语
  },
  "comment": {
    "zhCn": "短评",            //卡片短评 简体中文
    "enUs": "comment",        //卡片短评 英文（美国）
    "zhHk": "短評",            //卡片短评 繁体中文（香港）
    "zhTw": "短評",            //卡片短评 繁体中文（台湾）
    "enGb": "comment",        //卡片短评 英文（英国）
    "jaJp": "短いコメント"      //卡片短评 日语
  },
  "addOn": "额外信息或备注内容"     //描述性备注，非展示信息，仅用于审核
}

备注: 头像Url请使用能够直接以GET方法获取到的图像文件，否则可能出现无法显示的问题

若没有这样的文件，源代码中，文件夹QuetzalSidera.Me/wwwroot/img/choices/中也提供了一系列可以选择的图片。若选择该系列的图片，参数pictureLink请填写为 img/choices/文件名。例如选择 IMG_5050.PNG，参数pictureLink请填写img/choices/IMG_5050.PNG

请求示例(请求体保存为data.json文件)

curl -X POST "https://api.quetzalsidera.me/v1/checkList" \
     -H "Authorization: 4254bf69-a6d2-4602-872d-1d1546b25869" \
     -H "AuthToken: 44cc78fb-c2cc-4a37-bab4-72c4023e3ae0" \
     -H "Content-Type: application/json" \
     -d @data.json

成功响应示例：

{
  "status": 0,
  "message": "Ok",
  "data": "9a1a8a8a-c1ca-4257-a4db-152ccda550f9"
}

提示：请保存响应中的 data 字段值（卡片Guid），在下一步中可以用于检查审核状态。

4. 检查审核状态

使用步骤3中获得的卡片Guid作为参数，调用"检查卡片状态"API获取卡片审核状态。

请求示例：

curl -H "Authorization: 4254bf69-a6d2-4602-872d-1d1546b25869" \
     -H "AuthToken: 44cc78fb-c2cc-4a37-bab4-72c4023e3ae0" \
     "https://api.quetzalsidera.me/v1/checkList?cardGuid=933691ea-fdc0-4ea2-b2bc-9621e8b45fd8"

响应示例

正在审核

{
  "status": 0,
  "message": "Checking",
  "data": false
}

审核已结束

{
  "status": 0,
  "message": "Finished",
  "data": true
}

5. 等待展示

审核通过后，卡片将进入数据库。由于前端缓存机制，可能需要最长1小时才能在网站上显示。