123 云盘
  1. 上传图片
123 云盘
  • 首页
  • 官方接口
    • 接入指南
      • 开发者接入
        • 获取access_token
    • API列表
      • 文件管理
        • 上传
        • 重命名
        • 删除
        • 还原
        • 文件详情
        • 文件列表
          • 获取文件列表(推荐)
          • 获取文件列表(旧)
        • 移动
          • 移动
        • 下载
      • 图床
        • 上传图片
          • 上传流程说明
          • 创建目录
            POST
          • 创建文件
            POST
          • 获取上传地址
            POST
          • 上传分片
            PUT
          • 上传完毕
            POST
          • 异步轮询获取上传结果
            POST
        • 复制云盘图片
          • 创建复制任务
          • 获取复制任务详情
          • 获取复制失败文件列表
        • 获取目录/图片信息
          • 获取目录/图片详情
          • 获取目录/图片列表
        • 移动图片
          • 移动图片
        • 删除图片
          • 删除图片
        • 图床离线迁移
        • 重命名目录/图片
          • 重命名目录/图片
  • 补充文档
    • 申请clientID和clientSecret
    • 令牌access_token保存方案
  • Java 对接示例
  • Python 对接示例
  • JavaScript 对接示例
  1. 上传图片

获取上传地址

开发中
POST
/upload/v1/oss/file/get_upload_url

请求参数

Header 参数

Body 参数application/json

示例
{
    "preuploadID": "h1Kiaaaaaaac/0wEH17IFbdg8TNJMsMsuq60CiLiZre3dznF4J4zMwKnmKza7Xlb1bHKz5aFmrD1bJta74PAsR/+0zUQhO1GaLd5R9EPmk7dRsNWNZ/H67L0w939M5Mwi/yxHIJOgBXu69iWx6GGdLYlQuHIshoCw5HtI/yktv2WTf83J/pv+hl/TM7p8vQ4LCqW0YkdXraauJaddhiha57/+E7u27Uqd9xWgEOL4GsIoWMfE/0mRR70k5zSw5wKdNnPXr3a0qsnxkFfaKIne2R40OYqjcjRrwqW/A/gAjDmAi4uoESQm35nCc3YUDmTeFivgk2COokLXQwU3z5pvKpSWzCAusHvtnPrNkVV86hT8ymPTgL5pzYCqOR351TyAFGZvIlmEJnNZAknv5rgyFbbXEnIaad//7gKa0HgaFaa",
    "sliceNo": 1
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open-api.123pan.com/upload/v1/oss/file/get_upload_url' \
--header 'Platform: open_platform' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NjQ2NTk0NjYsImlhdCI6MTc2NDA1NDY2NiwiaWQiOjE4MTMwMDI3NjUsIm1haWwiOiJmZWl4aWFuZ25ldEBxcS5jb20iLCJuaWNrbmFtZSI6Iumjnue_lOS4reaWh-e9kSIsInVzZXJuYW1lIjoxNTExMjIyMDk1NSwidiI6MH0.N2YNoKyeGWt1TJLcpPN2WotzvymcEyUBd9eRbPZl7TU' \
--header 'Content-Type: application/json' \
--data-raw '{
    "preuploadID": "h1Kiaaaaaaac/0wEH17IFbdg8TNJMsMsuq60CiLiZre3dznF4J4zMwKnmKza7Xlb1bHKz5aFmrD1bJta74PAsR/+0zUQhO1GaLd5R9EPmk7dRsNWNZ/H67L0w939M5Mwi/yxHIJOgBXu69iWx6GGdLYlQuHIshoCw5HtI/yktv2WTf83J/pv+hl/TM7p8vQ4LCqW0YkdXraauJaddhiha57/+E7u27Uqd9xWgEOL4GsIoWMfE/0mRR70k5zSw5wKdNnPXr3a0qsnxkFfaKIne2R40OYqjcjRrwqW/A/gAjDmAi4uoESQm35nCc3YUDmTeFivgk2COokLXQwU3z5pvKpSWzCAusHvtnPrNkVV86hT8ymPTgL5pzYCqOR351TyAFGZvIlmEJnNZAknv5rgyFbbXEnIaad//7gKa0HgaFaa",
    "sliceNo": 1
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 0,
    "message": "ok",
    "data": {
        "presignedURL": "https://m106.123624.com/123-302/de9e0a75/1813002765-0/de9e0a75df3e82f318b4590f6742852e?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=7JOMZG52GXC4KNYKCRUQ%2F20251125%2Fdefault%2Fs3%2Faws4_request&X-Amz-Date=20251125T100210Z&X-Amz-Expires=1200&X-Amz-SignedHeaders=host&x-id=PutObject&X-Amz-Signature=6618121dc6c4b141634948b2f00c8a167ba5515843f7a0b2260fe6a4a341c1d4",
        "isMultipart": false
    },
    "x-traceID": "b9b67b90-42cf-4ec4-a6a5-bc332b16b086_kong-db-f7c8c6d76-nfszd"
}
上一页
创建文件
下一页
上传分片
Built with