Geliştiriciler

X.gd Developers

Harici uygulamalardan URL'leri kısaltmak için bir API sağlıyoruz. API'yi kullanmak için bir API anahtarı gereklidir.

URL Kısaltma API'si

Shorten API v1.0

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

İstek

*	Parameter	Type	Format	Description	Example
*	url	String	http(s)://	Kısaltılacak URL	https://example.com
	shortid	String	[0-9a-zA-Z_]{6,15}	Özel kısa URL. Atlanırsa rastgele atanır	example
	analytics	String	true / false	Analiz erişimini etkinleştir. Atlanırsa etkindir	true
	filterbots	String	true / false	Analiz etkinken botları filtrele. Atlanırsa devre dışıdır	false
*	key	String	[0-9a-f]{32}	Verilen API anahtarı	0af50e06255c7004f9ad71338f5ad56e

İstek Örneği (URL)

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

İstek Örneği (cURL)

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

Yanıt (Başarılı)

*	Parameter	Type	Format	Description	Example
*	status	Number	200	Durum kodu	200
*	shorturl	String	https://x.gd/[0-9a-zA-Z_]+	Kısaltılmış URL	https://x.gd/example
*	analytics	Boolean	true / false	Analiz erişimi	true
*	filterbots	Boolean	true / false	Bot filtreleme	false
*	originalurl	String	http(s)://	Orijinal URL	https://example.com

Yanıt Örneği

status: 200
content-type: application/json

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

Yanıt (Başarısız)

*	Parameter	Type	Format	Description	Example
*	status	Number	400 / 401 / 403 / 409 / 429 / 500 / 503	Durum kodu	429
*	message	String	-	Hata mesajı	Too many requests.

Yanıt Örneği

status: 200
content-type: application/json

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

Durum Kodu

Status	Description
200	Yanıt normal.
400	İstekte bir hata oluştu. Mesaj detayları içerir.
401	Token geçersiz. API anahtarınızı kontrol edin.
403	Geçici veya kalıcı olarak kullanılamıyor.
409	İstenen koşullar altında kısa URL verilemez. Mesaj detayları içerir.
429	API kullanım sınırına ulaştınız. Sınır kalkana kadar bekleyin ve tekrar aramayı deneyin.
500	Geçici bir sistem hatası oluştu. Bir süre sonra tekrar aramayı deneyin.
503	Hizmet geçici olarak kullanılamıyor. Bir süre sonra tekrar aramayı deneyin.

API Anahtarı

Girdiğiniz e-posta adresine API anahtarı verme URL'sini göndereceğiz.
Gönderdikten sonra 24 saat içinde işlemi tamamlamanız gerekir.