Developer · API gratis

API hosting gambar gratis

Unggah gambar dari aplikasi, bot, dan skrip Anda. Satu permintaan menghasilkan tautan langsung, HTML, BBCode, dan Markdown.

Dapatkan kunci API

Autentikasi

Buat kunci di Dasbor → Pengaturan → Kunci API. Kirimkan kunci tersebut di setiap permintaan:

Header

Authorization: Bearer YOUR_API_KEY

Simpan kunci di server Anda. Siapa pun yang memiliki kunci dapat mengunggah ke dan menghapus dari akun Anda.

Unggah gambar

POST /api/v1/upload

Kolom	Deskripsi
image	File gambar (multipart), hingga 4 MB
url	URL gambar publik yang akan diambil sebagai gantinya, hingga 32 MB
name	Judul opsional, digunakan untuk halaman gambar
expiresIn	Hapus otomatis opsional: 1h (1 jam), 1d (1 hari), 1w (1 minggu), 1m (1 bulan), 6m (6 bulan)

curl: unggah file

curl -X POST https://imgsharehub.com/api/v1/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "name=Login error"

curl: unggah dari URL

curl -X POST https://imgsharehub.com/api/v1/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/photo.jpg", "expiresIn": "1w"}'

Node.js

import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("image", new Blob([await readFile("photo.jpg")]), "photo.jpg");

const res = await fetch("https://imgsharehub.com/api/v1/upload", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.IMGSHAREHUB_KEY}` },
  body: form,
});
const { data } = await res.json();
console.log(data.direct_url);

Python

import os, requests

res = requests.post(
    "https://imgsharehub.com/api/v1/upload",
    headers={"Authorization": f"Bearer {os.environ['IMGSHAREHUB_KEY']}"},
    files={"image": open("photo.jpg", "rb")},
)
print(res.json()["data"]["direct_url"])

Respons (201)

JSON

{
  "success": true,
  "data": {
    "id": "a1b2c3",
    "url": "https://imgsharehub.com/a1b2c3",
    "direct_url": "https://imgsharehub.com/i/a1b2c3.webp",
    "html": "<a href=\"https://imgsharehub.com/a1b2c3\" target=\"_blank\"><img src=\"https://imgsharehub.com/i/a1b2c3.webp\" alt=\"Image hosted on ImgShareHub\" /></a>",
    "bbcode": "[url=https://imgsharehub.com/a1b2c3][img]https://imgsharehub.com/i/a1b2c3.webp[/img][/url]",
    "markdown": "[![Image](https://imgsharehub.com/i/a1b2c3.webp)](https://imgsharehub.com/a1b2c3)",
    "width": 1920,
    "height": 1080,
    "size": 284512,
    "private": false,
    "expires_at": null
  }
}

Ambil atau hapus gambar

Berlaku untuk gambar milik akun pemilik kunci. GET juga mengembalikan created_at dan views.

Ambil

curl https://imgsharehub.com/api/v1/images/a1b2c3 \
  -H "Authorization: Bearer YOUR_API_KEY"

Hapus

curl -X DELETE https://imgsharehub.com/api/v1/images/a1b2c3 \
  -H "Authorization: Bearer YOUR_API_KEY"

Batasan dan error

Setiap kunci dapat mengunggah 100 gambar per jam dan melakukan 1.000 permintaan lainnya per jam. Setiap respons menyertakan header X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset. Error mengembalikan {"success": false, "error": "..."}.

Status	Arti
400	Gambar tidak ada, file tidak didukung, file terlalu besar, atau URL tidak dapat diambil
401	Kunci API tidak ada, tidak dikenal, atau sudah dicabut
404	Gambar tidak ditemukan, atau bukan milik akun pemilik kunci Anda
429	Batas permintaan tercapai; lihat header X-RateLimit-Reset
500	Terjadi kesalahan di sisi kami; coba lagi nanti

Tanpa perlu kode

Plugin unggah forum menambahkan tombol unggah ke phpBB, MyBB, SMF, dan XenForo.
Konfigurasi ShareX mengunggah setiap screenshot secara otomatis di Windows.

Pertanyaan seputar API

Apakah API ImgShareHub gratis?

Ya. Buat hingga 5 kunci dari pengaturan akun Anda. Setiap kunci dapat mengunggah 100 gambar per jam.

Berapa ukuran file maksimum?

File yang dikirim langsung dalam permintaan dapat berukuran hingga 4 MB. Untuk gambar yang lebih besar, hingga 32 MB, kirim URL gambar publik dan ImgShareHub akan mengunduhnya.

Di mana gambar yang diunggah lewat API muncul?

Di dasbor akun pemilik kunci, bersama gambar yang Anda unggah di situs web.

Bisakah gambar yang diunggah kedaluwarsa secara otomatis?

Ya. Atur expiresIn ke salah satu dari: 1h (1 jam), 1d (1 hari), 1w (1 minggu), 1m (1 bulan), 6m (6 bulan). Gambar yang kedaluwarsa langsung berhenti dimuat.