Zkracovač URL

Koncový bod

GET https://xhp.cz/api/shorten

Vrací JSON odpověď s krátkou URL, vyřešeným kódem a časovým razítkem.

Parametry

Parametr	Typ	Povinný	Popis
url	string	Ano	URL ke zkrácení. Musí obsahovat http:// nebo https://.
custom	string	Ne	Vlastní krátký kód (3–20 znaků, pouze alfanumerické).

Příklady

Základní zkrácení s automaticky generovaným kódem:

GET https://xhp.cz/api/shorten?url=https://bizkithub.com

Odpověď:

{
"success": true,
"data": {
"short_url": "https://xhp.cz/abc123",
"original_url": "https://bizkithub.com",
"short_code": "abc123",
"created_at": "2025-01-15T10:30:00Z"
}
}

Vlastní krátký kód:

GET https://xhp.cz/api/shorten?url=https://bizkithub.com&custom=bizkithub

Odpověď:

{
"success": true,
"data": {
"short_url": "https://xhp.cz/bizkithub",
"original_url": "https://bizkithub.com",
"short_code": "bizkithub",
"created_at": "2025-01-15T10:30:00Z"
}
}

Analytika

Každá krátká URL automaticky zaznamenává:

• Celkový počet kliknutí a unikátních návštěvníků.
• Geografická poloha (země, město).
• Odkazující webové stránky.
• Časová razítka a vzorce kliknutí.

Analytika pro krátký kód je dostupná na dvou koncových bodech:

Kde	URL
Panel prohlížeče	https://xhp.cz/{code}+
JSON API	https://xhp.cz/api/stats/{code}

JavaScript pomocník

async function shortenURL(originalUrl, customCode = null) {
const params = new URLSearchParams({ url: originalUrl });
if (customCode) params.append('custom', customCode);
const response = await fetch(`https://xhp.cz/api/shorten?${params}`);
const data = await response.json();
if (!data.success) throw new Error(data.error ?? 'Nepodařilo se zkrátit URL');
return data.data.short_url;
}
async function getAnalytics(shortCode) {
const response = await fetch(`https://xhp.cz/api/stats/${shortCode}`);
return response.json();
}

Limity

Metrika	Hodnota
URL za hodinu na IP	500
Sledování kliknutí	Neomezené
Platnost URL	Nikdy
Přístup k analytice	Zdarma

Chybové odpovědi

Status	Význam
400	Neplatný formát URL nebo chybějící parametry.
409	Vlastní krátký kód již existuje.
429	Překročen limit frekvence — zkuste to znovu po krátké prodlevě.