Download file with extension:

curl -fSL https://lobfile.com/file/example.png -o example.png

Download file without extension:

curl -fSL https://lobfile.com/file/example -o example.png

Fetch SHA256 digest (returns plain text, not JSON):

curl -s https://lobfile.com/file/example.png.sha256

Upload a file:

curl -sS -X POST https://lobfile.com/api/v3/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/example.png"

Upload a file with SHA256 verification:

curl -sS -X POST https://lobfile.com/api/v3/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/example.png" \
  -F "sha_256=YOUR_SHA256_DIGEST"

Example success JSON:

{
  "success": true,
  "url": "https://lobfile.com/file/example.png"
}

Example error JSON:

{
  "success": false,
  "error": "Invalid API key"
}

Retrieve the account file list (defaults: upload_time desc, page 1, limit 200):

curl -sS -X GET "https://lobfile.com/api/v3/rest/get-file-list" \
  -H "X-API-Key: YOUR_API_KEY"

Retrieve the account file list (sort by name asc, page 2, limit 100):

curl -sS -X GET "https://lobfile.com/api/v3/rest/get-file-list?column=name&direction=asc&page=2&limit=100" \
  -H "X-API-Key: YOUR_API_KEY"

Example error (invalid key):

HTTP/1.1 401
{
  "success": false,
  "error": {
    "message": "Invalid API key",
    "code": "AUTH_INVALID_KEY"
  }
}

Toggle a file as favorite:

curl -sS -X POST "https://lobfile.com/api/v3/rest/toggle-favorite" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"file":"example"}'

Example success JSON:

{
  "success": true,
  "file_info": {
    "name": "example",
    "is_favorite": true
  }
}

Delete a single file:

curl -sS -X DELETE "https://lobfile.com/api/v3/rest/delete-files" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{ "files": ["s1ID"] }'

Delete multiple files:

curl -sS -X DELETE "https://lobfile.com/api/v3/rest/delete-files" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{ "files": ["P9uRkgR8", "9qs7q67Q"] }'

Example success JSON:

{
  "success": true,
  "deleted": [
    "example"
  ]
}

Example invalid body (shows error shape):

HTTP/1.1 400
{
  "success": false,
  "error": {
    "message": "Invalid request body. Expected JSON object with 'files' array.",
    "code": "INVALID_INPUT"
  }
}

Fetch account info:

curl -sS -X GET "https://lobfile.com/api/v3/rest/get-account-info" \
  -H "X-API-Key: YOUR_API_KEY"

Example (truncated) success JSON:

{
  "success": true,
  "account": {
    "info": {
      "email": "you@example.com",
      "level": "PlanName",
      "api_key": "••••••••••••",
      "time_created": "2024-01-02 03:04:05"
    },
    "limits": {
      "space_quota": 1234,
      "slots_quota": 1234,
      "max_file_size": 1234,
      "max_file_download_speed": 1234,
      "max_bandwidth_monthly": 1234
    },
    "usage": {
      "space_used": 1233,
      "slots_used": 1233,
      "bandwidth_used_month": 1233
    }
  }
}

Fetch account settings:

curl -sS -X GET "https://lobfile.com/api/v3/rest/get-account-settings" \
  -H "X-API-Key: YOUR_API_KEY"

Example (truncated) success JSON:

{
  "success": true,
  "account": {
    "settings": {
      "preferred_domain": "lobfile.com",
      "return_file_extension": true,
      "continuous_uploading": false,
      "preferred_filename_length": 12,
      "inactivity_auto_delete_days": 30,
      "timezone_auto": true,
      "timezone": "America/Los_Angeles"
    }
  }
}