Get file information by shortCodes (similar to DDownload API).
GET https://api.beecargo.net/files/info?file_code=shortCode1,shortCode2Optional: You can authenticate using an API key via the Authorization header or the key query parameter. Authentication is optional for this endpoint.
Authorization: Bearer YOUR_API_KEYOr use the key query parameter: ?key=YOUR_API_KEY
Get file information for one or more files by providing their shortCodes (comma-separated).
# 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"| Parameter | Type | Required | Description |
|---|---|---|---|
| file_code | String | Yes | Comma-separated list of shortCodes (e.g., "abc123,xyz789") |
| key | String | No | API key for authentication (alternative to Authorization header) |
Returns an array of file information objects. Each object has a status field indicating whether the file was found (200) or not found (404).
{
"msg": "OK",
"server_time": "2024-01-01 12:00:00",
"status": 200,
"result": [
{
"status": 200,
"filecode": "abc123",
"name": "document.pdf",
"size": "1048576",
"uploaded": "2024-01-01 10:00:00",
"download": "42",
"status_field": "active"
},
{
"status": 404,
"filecode": "xyz789"
},
{
"status": 200,
"filecode": "def456",
"name": "image.jpg",
"size": "524288",
"uploaded": "2024-01-01 11:00:00",
"download": "15",
"status_field": "active"
}
]
}| Field | Type | Description |
|---|---|---|
| msg | String | Response message ("OK" on success) |
| server_time | String | Server timestamp in "YYYY-MM-DD HH:MM:SS" format |
| status | Number | HTTP status code (200 for success) |
| result | Array | Array of file info objects |
| result[].status | Number | 200 if file found, 404 if not found |
| result[].filecode | String | The shortCode (short_id) of the file |
| result[].name | String | File name (only if status is 200) |
| result[].size | String | File size in bytes as string (only if status is 200) |
| result[].uploaded | String | Upload timestamp in "YYYY-MM-DD HH:MM:SS" format (only if status is 200) |
| result[].download | String | Download count as string (only if status is 200) |
| result[].status_field | String | File status: "active", "deleted", "dmca_removed", or "expired" (only if status is 200) |
{
"msg": "Bad Request",
"status": 400,
"error": "file_code parameter is required (comma-separated shortCodes)"
}