Download and unlock

Open a share code, unlock protected files, or request a signed download URL.

Start with the share address. Protection adds a second credential but does not change the public /d/{shortId} address.

Open https://beecargo.net/d/{shortId} directly. If you received only the share code, enter it at https://beecargo.net/get; Beecargo opens the same share page.

Open the share-code page

Protected recipient flow

If the share asks for a code, enter the separate 6-character unlock code supplied by the sender. If the sender supplied a /h/{token} delivery link, open it instead; the token authorizes the share without typing the code.

Sharing and protection

API and agent flow

Check unlockRequired in file or share metadata. POST /downloads/unlock accepts { shortId|fileId, unlockCode } or { handoffToken } and returns a short-lived unlockToken. Pass that token to the download endpoint, or pass the unlock code or handoff token directly.

APIRetrieve a fileGet a short-lived download URL for a file.

Endpoint

GEThttps://api.beecargo.net/files/download/[fileId]

Authentication

No API key needed. If the share is protected, pass unlockCode, unlockToken, or handoffToken.

Request examples

# Get download URL (unprotected)

curl https://api.beecargo.net/files/download/550e8400-e29b-41d4-a716-446655440000

# Protected share: unlock first, then download

curl -X POST https://api.beecargo.net/downloads/unlock \
  -H "Content-Type: application/json" \
  -d '{"shortId":"AbC123","unlockCode":"XyZ789"}'

curl "https://api.beecargo.net/files/download/550e8400-e29b-41d4-a716-446655440000?unlockCode=XyZ789"

# Download file directly

curl -L https://api.beecargo.net/files/download/550e8400-e29b-41d4-a716-446655440000 \
  -o downloaded-file.pdf

Parameters

Parameter	Type	Required	Description
`fileId`	String	Yes	File id from the upload response (short id, not a UUID)
`unlockCode`	String	No	6-character unlock code when the share is protected (query string)
`unlockToken`	String	No	Short-lived token from `POST /downloads/unlock` (query string)
`handoffToken`	String	No	Private token from `/h/{token}` (query string)

Usage notes

Send the file id. You get a signed URL that expires in about 1 hour. For protected shares, add unlock credentials as query params.
Returns a signed download URL that expires in about 1 hour (3600 seconds).
The signed URL expires in about 1 hour
Each call to this endpoint counts as a download
Fetch the file from the signed URL, not from this endpoint
Downloads are counted for analytics
Check unlockRequired on GET /files/share/:shortId or GET /files/info before downloading
POST /downloads/unlock with { shortId|fileId, unlockCode } or { handoffToken } returns unlockToken for later grant or download calls
Delivery links at /h/{token} unlock without typing the code; GET /files/handoff/:token returns the message and shortId

Open: Retrieve a file

MCPRetrieve a fileGet a signed download URL by `fileId` via MCP.

Tool

beecargo_get_download_url

Authentication

No API key required.

Parameters

Parameter	Type	Required	Description
`fileId`	String	Yes	File id from upload (`data.id`), not a UUID
`unlockCode`	String	No	6-character unlock code (needed when `unlockRequired` is true, unless you pass `unlockToken` or `handoffToken`)
`unlockToken`	String	No	Short-lived token from `POST /downloads/unlock` after a successful unlock
`handoffToken`	String	No	Secret from the delivery link `/h/{token}` (alternative to `unlockCode`)

Usage notes

Returns a temporary signed download URL for the given fileId. When the share is protected, pass unlockCode, unlockToken, or handoffToken.
Signed URLs expire (usually about 1 hour). Request a fresh one when needed.
Check unlockRequired with beecargo_file_info or GET /files/share/:shortId before calling this tool.
If unlockRequired is true, the /d/{shortId} link alone is not enough to download.

Open: Retrieve a file

APIGet file infoLook up file details by short codes.

Endpoint

GEThttps://api.beecargo.net/files/info

Authentication

Optional. You can send an API key in the Authorization header or as a key query param.

Or use the query param: ?key=YOUR_API_KEY

Request examples

# Get info for a single file

curl "https://api.beecargo.net/files/info?file_code=abc123"

# Get info for multiple files (comma-separated)

curl "https://api.beecargo.net/files/info?file_code=abc123,xyz789,def456"

# With API key authentication

curl "https://api.beecargo.net/files/info?file_code=abc123&key=YOUR_API_KEY"

# Or with Authorization header

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.beecargo.net/files/info?file_code=abc123,xyz789"

Parameters

Parameter	Type	Required	Description
`file_code`	String	Yes	Comma-separated short codes (e.g. `"abc123,xyz789"`)
`key`	String	No	API key (alternative to the `Authorization` header)

Response fields

Field	Type	Description
`msg`	String	Response message (`"OK"` on success)
`server_time`	String	Server time as `"YYYY-MM-DD HH:MM:SS"`
`status`	Number	HTTP status (200 on success)
`result`	Array	List of file info objects
`result[].status`	Number	200 if found, 404 if not
`result[].filecode`	String	Short code (`short_id`) of the file
`result[].name`	String	File name (when status is 200)
`result[].size`	String	Size in bytes as a string (when status is 200)
`result[].uploaded`	String	Upload time as `"YYYY-MM-DD HH:MM:SS"` (when status is 200)
`result[].download`	String	Download count as a string (when status is 200)
`result[].status_field`	String	File state: `"active"`, `"deleted"`, `"dmca_removed"`, or `"expired"` (when status is 200)
`result[].unlockRequired`	Boolean	True when download needs an unlock code or delivery link first (when status is 200)

Usage notes

Pass one or more short codes, separated by commas.
Returns an array of file objects. Each has a status of 200 (found) or 404 (not found).
You can look up several files at once with comma-separated short codes
Each item in result has its own status (200 or 404)
Only files with status "active" can be downloaded
When unlockRequired is true, GET /files/download/:fileId needs unlockCode or unlockToken (or call POST /downloads/unlock with handoffToken from /h/{token})
Auth is optional; a key can help with rate limits

Open: Get file info

MCPGet file infoLook up file metadata by short codes via MCP.

Tool

beecargo_file_info

Authentication

API key optional.

Parameters

Parameter	Type	Required	Description
`fileCodes`	String	Yes	Comma-separated short codes, e.g. `abc12,xyz99`

Usage notes

Batch lookup with comma-separated short codes (the public share id).
Same idea as GET /files/info?file_code=… on the API.
When a result has unlockRequired: true, call beecargo_get_download_url with unlockCode, unlockToken, or handoffToken. The share link alone is not enough to download.

Open: Get file info

API and agent flow

APIRetrieve a fileGet a short-lived download URL for a file.

Endpoint

GEThttps://api.beecargo.net/files/download/[fileId]

Authentication

No API key needed. If the share is protected, pass unlockCode, unlockToken, or handoffToken.

Request examples

# Get download URL (unprotected)

curl https://api.beecargo.net/files/download/550e8400-e29b-41d4-a716-446655440000

# Protected share: unlock first, then download

curl -X POST https://api.beecargo.net/downloads/unlock \
  -H "Content-Type: application/json" \
  -d '{"shortId":"AbC123","unlockCode":"XyZ789"}'

curl "https://api.beecargo.net/files/download/550e8400-e29b-41d4-a716-446655440000?unlockCode=XyZ789"

# Download file directly

curl -L https://api.beecargo.net/files/download/550e8400-e29b-41d4-a716-446655440000 \
  -o downloaded-file.pdf

Parameters

Parameter	Type	Required	Description
`fileId`	String	Yes	File id from the upload response (short id, not a UUID)
`unlockCode`	String	No	6-character unlock code when the share is protected (query string)
`unlockToken`	String	No	Short-lived token from `POST /downloads/unlock` (query string)
`handoffToken`	String	No	Private token from `/h/{token}` (query string)

Usage notes

Send the file id. You get a signed URL that expires in about 1 hour. For protected shares, add unlock credentials as query params.
Returns a signed download URL that expires in about 1 hour (3600 seconds).
The signed URL expires in about 1 hour
Each call to this endpoint counts as a download
Fetch the file from the signed URL, not from this endpoint
Downloads are counted for analytics
Check unlockRequired on GET /files/share/:shortId or GET /files/info before downloading
POST /downloads/unlock with { shortId|fileId, unlockCode } or { handoffToken } returns unlockToken for later grant or download calls
Delivery links at /h/{token} unlock without typing the code; GET /files/handoff/:token returns the message and shortId

Open: Retrieve a file

MCPRetrieve a fileGet a signed download URL by `fileId` via MCP.

Tool

beecargo_get_download_url

Authentication

No API key required.

Parameters

Parameter	Type	Required	Description
`fileId`	String	Yes	File id from upload (`data.id`), not a UUID
`unlockCode`	String	No	6-character unlock code (needed when `unlockRequired` is true, unless you pass `unlockToken` or `handoffToken`)
`unlockToken`	String	No	Short-lived token from `POST /downloads/unlock` after a successful unlock
`handoffToken`	String	No	Secret from the delivery link `/h/{token}` (alternative to `unlockCode`)

Usage notes

Returns a temporary signed download URL for the given fileId. When the share is protected, pass unlockCode, unlockToken, or handoffToken.
Signed URLs expire (usually about 1 hour). Request a fresh one when needed.
Check unlockRequired with beecargo_file_info or GET /files/share/:shortId before calling this tool.
If unlockRequired is true, the /d/{shortId} link alone is not enough to download.

Open: Retrieve a file

APIGet file infoLook up file details by short codes.

Endpoint

GEThttps://api.beecargo.net/files/info

Authentication

Optional. You can send an API key in the Authorization header or as a key query param.

Or use the query param: ?key=YOUR_API_KEY

Request examples

# Get info for a single file

curl "https://api.beecargo.net/files/info?file_code=abc123"

# Get info for multiple files (comma-separated)

curl "https://api.beecargo.net/files/info?file_code=abc123,xyz789,def456"

# With API key authentication

curl "https://api.beecargo.net/files/info?file_code=abc123&key=YOUR_API_KEY"

# Or with Authorization header

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.beecargo.net/files/info?file_code=abc123,xyz789"

Parameters

Parameter	Type	Required	Description
`file_code`	String	Yes	Comma-separated short codes (e.g. `"abc123,xyz789"`)
`key`	String	No	API key (alternative to the `Authorization` header)

Response fields

Field	Type	Description
`msg`	String	Response message (`"OK"` on success)
`server_time`	String	Server time as `"YYYY-MM-DD HH:MM:SS"`
`status`	Number	HTTP status (200 on success)
`result`	Array	List of file info objects
`result[].status`	Number	200 if found, 404 if not
`result[].filecode`	String	Short code (`short_id`) of the file
`result[].name`	String	File name (when status is 200)
`result[].size`	String	Size in bytes as a string (when status is 200)
`result[].uploaded`	String	Upload time as `"YYYY-MM-DD HH:MM:SS"` (when status is 200)
`result[].download`	String	Download count as a string (when status is 200)
`result[].status_field`	String	File state: `"active"`, `"deleted"`, `"dmca_removed"`, or `"expired"` (when status is 200)
`result[].unlockRequired`	Boolean	True when download needs an unlock code or delivery link first (when status is 200)

Usage notes

Pass one or more short codes, separated by commas.
Returns an array of file objects. Each has a status of 200 (found) or 404 (not found).
You can look up several files at once with comma-separated short codes
Each item in result has its own status (200 or 404)
Only files with status "active" can be downloaded
When unlockRequired is true, GET /files/download/:fileId needs unlockCode or unlockToken (or call POST /downloads/unlock with handoffToken from /h/{token})
Auth is optional; a key can help with rate limits

Open: Get file info

MCPGet file infoLook up file metadata by short codes via MCP.

Tool

beecargo_file_info

Authentication

API key optional.

Parameters

Parameter	Type	Required	Description
`fileCodes`	String	Yes	Comma-separated short codes, e.g. `abc12,xyz99`

Usage notes

Batch lookup with comma-separated short codes (the public share id).
Same idea as GET /files/info?file_code=… on the API.
When a result has unlockRequired: true, call beecargo_get_download_url with unlockCode, unlockToken, or handoffToken. The share link alone is not enough to download.

Open: Get file info