Dezvoltatori

X.gd Developers

Oferim un API pentru scurtarea URL-urilor din aplicații externe. Pentru a utiliza API-ul este necesară o cheie API.

API scurtare URL

Shorten API v1.0

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

Cerere

*	Parameter	Type	Format	Description	Example
*	url	String	http(s)://	URL de scurtat	https://example.com
	shortid	String	[0-9a-zA-Z_]{6,15}	URL scurt personalizat. Atribuire aleatorie dacă este omis	example
	analytics	String	true / false	Activați analiza accesului. Activat dacă este omis	true
	filterbots	String	true / false	Filtrarea boților când analiza este activată. Dezactivat dacă este omis	false
*	key	String	[0-9a-f]{32}	Cheie API emisă	0af50e06255c7004f9ad71338f5ad56e

Exemplu cerere (URL)

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

Exemplu cerere (cURL)

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

Răspuns (Succes)

*	Parameter	Type	Format	Description	Example
*	status	Number	200	Cod de stare	200
*	shorturl	String	https://x.gd/[0-9a-zA-Z_]+	URL scurtat	https://x.gd/example
*	analytics	Boolean	true / false	Analiză acces	true
*	filterbots	Boolean	true / false	Filtrare boți	false
*	originalurl	String	http(s)://	URL original	https://example.com

Exemplu răspuns

status: 200
content-type: application/json

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

Răspuns (Eșuat)

*	Parameter	Type	Format	Description	Example
*	status	Number	400 / 401 / 403 / 409 / 429 / 500 / 503	Cod de stare	429
*	message	String	-	Mesaj eroare	Too many requests.

Exemplu răspuns

status: 200
content-type: application/json

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

Cod de stare

Status	Description
200	Răspunsul este normal.
400	A apărut o eroare în cerere. Mesajul conține detalii.
401	Token-ul este invalid. Verificați cheia API.
403	Temporar sau permanent indisponibil.
409	Nu se poate emite URL scurtat în condițiile solicitate. Mesajul conține detalii.
429	Ați atins limita de utilizare API. Așteptați eliberarea limitei și încercați să apelați din nou.
500	A apărut temporar o eroare de sistem. Încercați să apelați din nou după un timp.
503	Serviciul este temporar indisponibil. Încercați să apelați din nou după un timp.

Cheie API

Vom trimite URL-ul pentru emiterea cheii API la adresa de e-mail pe care ați introdus-o.
Trebuie să finalizați procedura în 24 de ore de la trimitere.