Pengembang | X.gd

X.gd Developers

Kami menyediakan API untuk memendekkan URL dari aplikasi eksternal. Kunci API diperlukan untuk menggunakan API.

API Pemendek URL

Shorten API v1.0

GET https://xgd.io/V1/shorten

Permintaan

*	Parameter	Type	Format	Description	Example
*	url	String	http(s)://	URL yang akan dipendekkan	https://example.com
	shortid	String	[0-9a-zA-Z_]{6,15}	URL pendek kustom. Ditetapkan secara acak jika diabaikan	example
	analytics	String	true / false	Aktifkan akses analitik. Diaktifkan jika diabaikan	true
	filterbots	String	true / false	Filter bot saat analitik diaktifkan. Dinonaktifkan jika diabaikan	false
*	key	String	[0-9a-f]{32}	Kunci API yang diterbitkan	0af50e06255c7004f9ad71338f5ad56e

Contoh Permintaan (URL)

https://xgd.io/V1/shorten?url=https://example.com&key={Your API Key}

Contoh Permintaan (cURL)

curl -X GET 'https://xgd.io/V1/shorten?url=https://example.com&key={Your API Key}'

Respons (Berhasil)

*	Parameter	Type	Format	Description	Example
*	status	Number	200	Kode status	200
*	shorturl	String	https://x.gd/[0-9a-zA-Z_]+	URL yang dipendekkan	https://x.gd/example
*	analytics	Boolean	true / false	Akses analitik	true
*	filterbots	Boolean	true / false	Pemfilteran bot	false
*	originalurl	String	http(s)://	URL asli	https://example.com

Contoh Respons

status: 200
content-type: application/json

{
    "status": 200,
    "shorturl": "https://x.gd/example",
    "analytics": true,
    "filterbots": false,
    "originalurl": "https://example.com/"
}

Respons (Gagal)

*	Parameter	Type	Format	Description	Example
*	status	Number	400 / 401 / 403 / 409 / 429 / 500 / 503	Kode status	429
*	message	String	-	Pesan kesalahan	Too many requests.

Contoh Respons

status: 200
content-type: application/json

{
    "status": 429,
    "message": "Too many requests."
}

Kode Status

Status	Description
200	Respons normal.
400	Terjadi kesalahan dalam permintaan. Pesan berisi detail.
401	Token tidak valid. Periksa kunci API Anda.
403	Sementara atau permanen tidak tersedia.
409	Tidak dapat mengeluarkan URL pendek di bawah kondisi yang diminta. Pesan berisi detail.
429	Anda telah mencapai batas penggunaan API. Tunggu hingga batas dicabut dan coba panggil lagi.
500	Terjadi kesalahan sistem sementara. Coba panggil lagi setelah beberapa saat.
503	Layanan sementara tidak tersedia. Coba panggil lagi setelah beberapa saat.

Kunci API

Kami akan mengirim URL penerbitan kunci API ke alamat email yang Anda masukkan.
Anda harus menyelesaikan proses dalam waktu 24 jam setelah pengiriman.