Masdika CDN Lab - API Hub

Masdika CDN provides a fast and secure storage solution. You can upload files (such as images, videos, and documents) using the POST method, and retrieve them anytime using the GET method.

1. Authentication

All API requests must include your API Key. You can pass the API Key in two ways:

Via HTTP Header: Add Authorization: Bearer <API_KEY>
Via URL Parameter: Add ?apikey=<API_KEY> to the endpoint URL.

2. Uploading a File (POST)

Send a POST request to https://masdika.id/api/public/upload with the request body containing the file you want to upload (form-data). You can also set the expiration time by passing an expiresIn field (options: 1d, 1w, 1m, permanent).

1cURL

A simple way to test the API directly from your terminal.

cURL

curl -X POST \
  https://masdika.id/api/public/upload \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'file=@/path/to/image.png' \
  -F 'expiresIn=1d'

2Node.js

Using the native fetch API and form-data library in Node.js.

Node.js

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

const formData = new FormData();
formData.append('file', fs.createReadStream('/path/to/image.png'));
formData.append('expiresIn', '1d');

fetch('https://masdika.id/api/public/upload', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    ...formData.getHeaders()
  },
  body: formData
})
.then(res => res.json())
.then(console.log);

3Python

A clean implementation using the popular requests library in Python.

Python

import requests

url = "https://masdika.id/api/public/upload"
headers = { "Authorization": "Bearer YOUR_API_KEY" }
data = { "expiresIn": "1d" }
files = { "file": open("/path/to/image.png", "rb") }

response = requests.post(url, headers=headers, data=data, files=files)
print(response.json())

4PHP

Standard cURL implementation for PHP applications.

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://masdika.id/api/public/upload',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('file'=> new CURLFILE('/path/to/image.png'), 'expiresIn' => '1d'),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer YOUR_API_KEY'
  ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;

5Ruby

Uploading multipart form data using Ruby's standard net/http library.

Ruby

require 'net/http/post/multipart'

url = URI.parse('https://masdika.id/api/public/upload')
File.open('/path/to/image.png') do |jpg|
  req = Net::HTTP::Post::Multipart.new url.path,
    "file" => UploadIO.new(jpg, "image/png", "image.png"),
    "expiresIn" => "1d"
  req['Authorization'] = 'Bearer YOUR_API_KEY'
  res = Net::HTTP.start(url.host, url.port, use_ssl: true) do |http|
    http.request(req)
  end
  puts res.body
end

6Golang

Using Go's standard library to construct and send multipart requests.

Golang

package main

import (
	"bytes"
	"fmt"
	"io"
	"mime/multipart"
	"net/http"
	"os"
)

func main() {
	url := "https://masdika.id/api/public/upload"
	method := "POST"

	payload := &bytes.Buffer{}
	writer := multipart.NewWriter(payload)
	writer.WriteField("expiresIn", "1d")
	file, _ := os.Open("/path/to/image.png")
	defer file.Close()

	part, _ := writer.CreateFormFile("file", "/path/to/image.png")
	io.Copy(part, file)
	writer.Close()

	client := &http.Client{}
	req, _ := http.NewRequest(method, url, payload)
	req.Header.Add("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", writer.FormDataContentType())

	res, _ := client.Do(req)
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

3. Retrieving a File (GET)

Send a request GET to the following URL to download or view the file.

GET Request

https://www.masdika.id/api/public/upload?token=<FILE_TOKEN>

INITIALIZING

INITIALIZING

INITIALIZING

Masdika CDN

Masdika CDN User Guide

1. Authentication

2. Uploading a File (POST)

1cURL

2Node.js

3Python

4PHP

5Ruby

6Golang

3. Retrieving a File (GET)