API • URUSAI!

檔案上傳

API URL (1)

API URL (2)

請求方法

內容類型

注意事項

API 上傳將保留原檔。
如有隱私或檔案大小考量，請先自行壓縮並清除 EXIF 資訊。

可用參數

file (必要)
要上傳的檔案，一次限一個，多檔案請分開上傳，每個檔案大小不得超過 50MB。
token (選填)
存取憑證，如未提供，將以匿名方式上傳。
r18 (選填)
是否為 NSFW 內容。
傳入 1 表示 NSFW，0 表示非 NSFW，預設為 0。
sha256 (選填)
欲驗證檔案完整性時請帶入此參數。若未提供，系統將跳過 SHA256 雜湊值校驗。

Example (curl)

curl -X POST https://api.urusai.cc/v1/upload \
    -F "[email protected]" \
    -F "r18=0" \
    -F "token=" \
    -F "sha256="

Example Response (JSON)

{
    "status": "success",
    "message": "uploaded",
    "data": {
        "id": "shine",
        "r18": "0",
        "filename": "urusai.png",
        "url_preview": "https://i.urusai.cc/shine",
        "url_direct": "https://i.urusai.cc/shine.png",
        "url_delete": "https://urusai.cc/del/abcd1234",
        "mime": "image/png"
    }
}

ShareX (sxcu)

{
  "Version": "18.0.1",
  "Name": "URUSAI!",
  "DestinationType": "ImageUploader, TextUploader, FileUploader",
  "RequestMethod": "POST",
  "RequestURL": "https://api-v1-t2-upload.urusai.cc",
  "Body": "MultipartFormData",
  "FileFormName": "file",
  "Arguments": {
    "token": "",
    "r18": "0"
  },
  "URL": "{json:data.url_direct}",
  "ThumbnailURL": "{json:data.url_preview}",
  "DeletionURL": "{json:data.url_delete}",
  "ErrorMessage": "{json:message}",
  "ResponseType": "JSON"
}

創建相簿

API URL

請求方法

內容類型

可用參數

fileid (必要)
相簿中所要引用的檔案 ID，需為陣列格式，最多 50 個，例如：[shine,YABAI] 或在 curl 中以多個 fileid 欄位傳入。
token (選填)
存取憑證，如未提供，將以匿名方式上傳。

Example (curl)

curl -X POST https://api.urusai.cc/v1/album \
    -F "fileid=shine" \
    -F "fileid=YABAI" \
    -F "token="

Example Response (JSON)

{
    "status": "success",
    "message": "uploaded",
    "url": "https://i.urusai.cc/a/shine",
    "delete": "https://urusai.cc/a/del/abcd1234",
    "fileid": "shine, YABAI"
}

用戶查詢

API URL

請求方法

內容類型

請求限制

一般用戶每次查詢僅能取得最新的 300 筆資料。

可用參數

username (必要)
token (必要)
type (必要)
資源類型。file=檔案、album=相簿。

File Example (curl)

curl -X POST https://api.urusai.cc/v1/repository \
    -F "username=test123" \
    -F "token=123456789" \
    -F "type=file"

File Example Response (JSON)

{
    "status": "success",
    "message": "success",
    "total": "2",
    "data": [
        {
            "id": "shine",
            "time": "1758123458",
            "r18": "0",
            "filename": "urusai.png",
            "url_preview": "https://i.urusai.cc/shine",
            "url_direct": "https://i.urusai.cc/shine.png",
            "mime": "image/png"
        },
        {
            "id": "Kawai",
            "time": "1758123459",
            "r18": "0",
            "filename": "Kawai.webp",
            "url_preview": "https://i.urusai.cc/Kawai",
            "url_direct": "https://i.urusai.cc/Kawai.webp",
            "mime": "image/webp"
        }
    ]
}

Album Example (curl)

curl -X POST https://api.urusai.cc/v1/repository \
    -F "username=test123" \
    -F "token=123456789" \
    -F "type=album"

Album Example Response (JSON)

{
    "status": "success",
    "message": "success",
    "total": "2",
    "data": [
        {
            "time": "1758123456",
            "url": "https://i.urusai.cc/a/shine",
            "fileid": "shine, YABAI"
        },
        {
            "time": "1758123457",
            "url": "https://i.urusai.cc/a/test1",
            "fileid": "shine, Kawai"
        }
    ]
}

刪除

API URL

請求方法

內容類型

注意事項

若透過 URL 刪除，請在 Query String 中加入以下參數：
t=1：執行直接刪除
json=1：以 JSON 格式回傳執行結果
範例：https://urusai.cc/del/3XXXXXIo?t=1&json=1

File Example (curl)

curl -X POST https://api.urusai.cc/v1/delete \
    -F "token=123456789" \
    -F "type=file" \
    -F "hash=shine"

Album Example (curl)

curl -X POST https://api.urusai.cc/v1/delete \
    -F "token=123456789" \
    -F "type=album" \
    -F "hash=hello"

Example Response (JSON)

{
    "status": "success",
    "message": "success",
}