Geliştirici API Dokümantasyonu

Kimlik Doğrulama

API anahtarınızı Authorization başlığı (header) üzerinden Bearer token şemasıyla iletmeniz gerekmektedir.

Authorization: Bearer YOUR_API_KEY

API anahtarınızı panelin API sekmesinden alabilir, dilediğiniz zaman yenileyebilirsiniz.

Endpoint Adresi

POST /api.php Kısa link oluşturur

https://kisa.tr/api.php

Parametreler

Alan	Tip	Zorunlu	Açıklama
url	string	Evet	Kısaltılacak adres. Sadece http ve https kabul edilir.
alias	string	Hayır	Özel kısa ad. 3-32 karakter; harf, rakam, tire, alt çizgi.
targets	object	Hayır	Akıllı yönlendirme hedefleri: `ios`, `android`, `desktop`

Akıllı Yönlendirme

Uygulamanız için tek bir kısa link oluşturun. iPhone kullanıcısı App Store'a, Android kullanıcısı Play Store'a, bilgisayardan girenler web sitenize gider. Reklamlarınızda, kartvizitinizde ve afişlerinizde tek adres kullanın.

İstek gövdesi

{
  "url": "https://ornek.com",
  "alias": "uygulamam",
  "targets": {
    "ios":     "https://apps.apple.com/app/id123456789",
    "android": "https://play.google.com/store/apps/details?id=com.ornek",
    "desktop": "https://ornek.com/indir"
  }
}

Eşleşme olmadığında ve boş bırakılan platformlarda bu adres kullanılır.

Yanıt Formatı

Başarılı (200 OK)

{
  "success": true,
  "short_url": "https://kisa.tr/aB3dE",
  "short_code": "aB3dE",
  "long_url": "https://ornek.com"
}

Hata (4xx/5xx)

{
  "success": false,
  "error": "Invalid or expired API Key."
}

Hata Kodları

Kod	Anlamı
400	Geçersiz URL veya alias formatı
401	API anahtarı eksik ya da Bearer formatında değil
403	Anahtar geçersiz, süresi dolmuş veya hesap askıda
405	Yalnızca POST metodu desteklenir
409	İstenen alias zaten kullanımda
429	Dakikalık istek limiti aşıldı

Kod Örnekleri

cURL

curl -X POST https://kisa.tr/api.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"url":"https://ornek.com","alias":"kampanya"}'

PHP

<?php
$ch = curl_init('https://kisa.tr/api.php');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Authorization: Bearer YOUR_API_KEY',
    ],
    CURLOPT_POSTFIELDS => json_encode(['url' => 'https://ornek.com']),
]);
$result = json_decode(curl_exec($ch), true);
echo $result['short_url'];

JavaScript (Fetch)

const res = await fetch('https://kisa.tr/api.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({ url: 'https://ornek.com' })
});
const data = await res.json();
console.log(data.short_url);

Python

import requests

res = requests.post(
    'https://kisa.tr/api.php',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={'url': 'https://ornek.com'}
)
print(res.json()['short_url'])

Limitler

60

istek / dakika · anahtar başına

∞

Premium hesapta toplam link sayısı

Tek istekte entegre olun