Tezkor, bepul va ishonchli. QR kod va statistika bilan.
Xush kelibsiz!
Click, create, delete hodisalarini tashqi URL ga yuboradi
URL klik bo'lganda tashqi sisteminzga xabar yuboring
POST https://iurl.uz/shorten
Content-Type: application/json
X-API-Key: iurl_xxxxxxxxxxxx
{
"original": "https://example.com/uzun-havola",
"custom": "MYLINK", // ixtiyoriy, 4-20 belgi
"expiresIn": 86400000, // ixtiyoriy, ms (1 kun)
"password": "secretpass" // ixtiyoriy
}
// Javob:
{
"status": true,
"data": {
"shortUrl": "https://iurl.uz/MYLINK",
"statsUrl": "https://iurl.uz/MYLINK/stats",
"short": "MYLINK",
"expiresAt": "2025-02-01T00:00:00.000Z",
"protected": false
}
}
POST https://iurl.uz/api/bulk-shorten
X-API-Key: iurl_xxxxxxxxxxxx
{
"urls": [
"https://example.com/1",
{ "original": "https://example.com/2", "custom": "LINK2" }
]
}
// Javob:
{
"status": true,
"data": {
"processed": 2,
"results": [
{ "success": true, "short": "AB12345", "shortUrl": "https://iurl.uz/AB12345" },
{ "success": false, "error": "Kod band" }
]
}
}
GET https://iurl.uz/short/ABC1234
// Javob:
{
"data": {
"clicks": 340,
"analytics": {
"browsers": [{ "name": "Chrome", "count": 98 }],
"oses": [{ "name": "Windows", "count": 120 }],
"devices": [{ "name": "desktop", "count": 280 }],
"countries": [{ "name": "Uzbekistan", "count": 200 }],
"dailyClicks":[{ "date": "2025-01-15", "count": 18 }]
}
}
}
// Node.js — so'rovni tekshirish
const sig = req.headers['x-iurl-signature'];
const expected = crypto
.createHmac('sha256', YOUR_WEBHOOK_SECRET)
.update(req.body) // raw body string
.digest('hex');
if (sig !== expected) return res.sendStatus(401);
// Webhook payload:
{
"event": "click", // "click" | "create" | "delete"
"timestamp": "2025-01-15T...",
"data": {
"short": "ABC1234",
"country": "Uzbekistan",
"browser": "Chrome",
"os": "Windows"
}
}
// Node.js / Browser
import iURL from './sdk.js';
const client = new iURL('iurl_xxxxxxxxxxxx');
// Qisqartirish
const { shortUrl } = await client.shorten('https://example.com/uzun');
// Bulk
const results = await client.bulkShorten([
'https://example.com/a',
'https://example.com/b',
]);
// Statistika
const stats = await client.stats('ABC1234');
from sdk import iURLClient
client = iURLClient("iurl_xxxxxxxxxxxx")
# Qisqartirish
result = client.shorten("https://example.com/uzun")
print(result["shortUrl"])
# Bulk
results = client.bulk_shorten([
"https://example.com/a",
"https://example.com/b",
])
# Statistika
stats = client.stats("ABC1234")
print(stats["clicks"])
<?php
require 'sdk.php';
$client = new iURLClient('iurl_xxxxxxxxxxxx');
// Qisqartirish
$result = $client->shorten('https://example.com/uzun');
echo $result['shortUrl'];
// Bulk
$results = $client->bulkShorten([
'https://example.com/a',
'https://example.com/b',
]);
// Statistika
$stats = $client->stats('ABC1234');
echo $stats['clicks'];
// Global: 120 so'rov/daqiqa (IP bo'yicha)
// /shorten: 20 so'rov/daqiqa
// /bulk-shorten: 5 so'rov/daqiqa
// Har bir API kalit uchun alohida limit:
// Free: 60 so'rov/daqiqa, max 3 kalit, 50 URL
// Pro: 300 so'rov/daqiqa, max 10 kalit, 500 URL
// Unlimited: 600 so'rov/daqiqa, max 20 kalit, ∞ URL
// 429 xatosi bo'lsa:
{
"status": false,
"message": "Rate limit: 60 so'rov/daqiqa"
}
// Retry-After headerini tekshiring
iURL.uz xizmatidan foydalanish orqali siz ushbu maxfiylik siyosatini qabul qilasiz. Biz sizning shaxsiy ma'lumotlaringizni himoya qilishga va shaffoflikni ta'minlashga intilamiz.
Biz quyidagi ma'lumotlarni to'playmiz:
Shaxsiy ma'lumotlaringiz sotilmaydi. Faqat quyidagi hollarda ulashiladi:
Faqat autentifikatsiya uchun HttpOnly cookie
ishlatiladi. Reklama yoki tracking cookie'lar yo'q.
Barcha ma'lumotlaringizni o'chirish uchun: [email protected]. So'rov 7 ish kuni ichida bajariladi.
iURL.uz xizmatidan foydalanishdan oldin ushbu shartlarni diqqat bilan o'qing. Xizmatdan foydalanish shartlarni qabul qilganligingizni bildiradi.
iURL.uz — URL qisqartirish, QR kod yaratish va klik statistikasi xizmati. SharqSoft tomonidan taqdim etiladi.
API kalitlari faqat ushbu shartlar doirasida ishlatilishi mumkin. Har bir kalit uchun 60 so'rov/daqiqa limiti mavjud.
Texnik ishlar yoki force majeure holatlarida xizmat vaqtincha to'xtatilishi mumkin. Biz ma'lumot yo'qolishi uchun javobgarlik olmaymiz.
Qoidalarni buzganda, shikoyat yoki huquqiy talab bo'lganda URL ogohlantirishsiz o'chirilishi mumkin.
iURL.uz qisqartirilgan URL orqali tarqatiladigan kontent uchun javobgar emas. Foydalanuvchi o'zi yaratgan URLlar uchun to'liq javobgarlik oladi.
Shartlar istalgan vaqtda o'zgartirilishi mumkin. Xizmatdan foydalanishni davom ettirish yangi shartlarni qabul qilish sifatida baholanadi.
[email protected] · SharqSoft · Toshkent, O'zbekiston
Har bir qatorda bitta URL yozing (max 100 ta)