一、接口概述

接口 URL（示例）
https://521.im/upapi.php

请求方式：POST

---

二、请求头（Headers）

字段名	必选	说明
Content-Type	是	multipart/form-data（上传文件时必须）
Token	是	接口验证使用的固定字符串，示例值为 521.im

---

三、请求参数

image

• 类型：文件（file）
• 必选：是
• 说明：要上传的图片，支持 JPG/PNG/GIF/WEBP。
• 限制：单张图片最大 10MB。

---

四、返回格式

所有返回均为 JSON，且 Content-Type: application/json; charset=utf-8。

1. 上传成功

{
  "code": 200,
  "msg": "success",
  "url": "https://521.im/NGi9Qq4S.jpeg",
  "time": "0.3s",
  "success": true
}

• code：数值型，200 表示成功。
• msg：字符串，返回 "success"。
• url：字符串，上传到 Telegram 并映射后的访问地址。
• time：字符串，接口从接收到返回结果所花费的总时长，保留一位小数，单位为秒。
• success：布尔型，表示本次操作是否成功；成功时为 true。

2. 常见失败返回样例

1. Token 验证失败
   HTTP/1.1 403 Forbidden

   {
     "success": false,
     "message": "无效的Token"
   }

2. 图片上传参数缺失或错误
   

   {
     "code": 400,
     "msg": "图片上传失败"
   }

3. 文件类型不支持
   

   {
     "code": 400,
     "msg": "只支持 JPG, PNG, GIF, WEBP 格式的图片"
   }

4. 文件过大（超过 10MB）
   

   {
     "code": 400,
     "msg": "图片大小不能超过10MB"
   }

5. 会话限流（请求过于频繁）
   

   {
     "code": 429,
     "success": false,
     "message": "请求太快了~"
   }