# Omit bucket_id to upload to S3 Buckets (s3-buckets)
curl -X POST https://dcloudx.net/api/v1/upload-object \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@/path/to/photo.jpg" \
  -F "folder=media"

curl "https://dcloudx.net/api/v1/objects?page=1&per_page=20" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl "https://dcloudx.net/api/v1/objects/123/url?expires_in=3600" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X DELETE "https://dcloudx.net/api/v1/objects/123" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl "https://dcloudx.net/api/v1/storage-usage" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl "https://dcloudx.net/api/v1/storage-buckets" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://dcloudx.net/api/v1/upload-object',
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_TOKEN',
    ],
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile('/path/to/photo.jpg', 'image/jpeg', 'photo.jpg'),
        'folder' => 'media',
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($curl);
$data = json_decode($response, true);
$cdnUrl = $data['object']['url'] ?? null; // use in <img src>

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://dcloudx.net/api/v1/objects/123',
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_TOKEN'],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($curl);

use Illuminate\Support\Facades\Http;

$response = Http::withToken('YOUR_API_TOKEN')
    ->attach('file', file_get_contents($path), 'photo.jpg')
    ->post('https://dcloudx.net/api/v1/upload-object', [
        'folder' => 'products',
    ]);

$data = $response->json();
$objectId = $data['object']['id'];
$cdnUrl   = $data['object']['url'];

$response = Http::withToken('YOUR_API_TOKEN')
    ->get('https://dcloudx.net/api/v1/objects/' . $objectId . '/url', [
        'expires_in' => 3600,
    ]);

$cdnUrl = $response->json('url');

const form = new FormData();
form.append('file', fileBuffer, 'photo.jpg');
form.append('folder', 'media');

const res = await fetch('https://dcloudx.net/api/v1/upload-object', {
  method: 'POST',
  headers: { Authorization: 'Bearer YOUR_API_TOKEN' },
  body: form,
});
const { object } = await res.json();
console.log(object.url); // CDN link for your website

const res = await fetch('https://dcloudx.net/api/v1/objects?page=1', {
  headers: { Authorization: 'Bearer YOUR_API_TOKEN' },
});
const page = await res.json();
// page.data = array of objects, each with .url for CDN

const res = await fetch('https://dcloudx.net/api/v1/objects/123/url?expires_in=3600', {
  headers: { Authorization: 'Bearer YOUR_API_TOKEN' },
});
const { url } = await res.json();
document.querySelector('#hero-image').src = url;

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const form = new FormData();
form.append('file', fs.createReadStream('./photo.jpg'));
form.append('folder', 'media');

const { data } = await axios.post('https://dcloudx.net/api/v1/upload-object', form, {
  headers: {
    ...form.getHeaders(),
    Authorization: 'Bearer YOUR_API_TOKEN',
  },
});
console.log(data.object.url);

import requests

with open('photo.jpg', 'rb') as f:
    response = requests.post(
        'https://dcloudx.net/api/v1/upload-object',
        headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
        files={'file': ('photo.jpg', f, 'image/jpeg')},
        data={'folder': 'media'},
    )

data = response.json()
cdn_url = data['object']['url']

import requests

response = requests.get(
    'https://dcloudx.net/api/v1/objects',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
    params={'page': 1, 'per_page': 20},
)
objects = response.json()['data']

<!-- Get url from API upload/list response (server-side) -->
<img src="PASTE_CDN_URL_FROM_API" alt="Product photo" width="400" />

<!-- Store object.id in your database; refresh url before it expires -->