YOURLS uyumlu API

S.EE, YOURLS API'sini destekleyen mevcut üçüncü taraf istemciler ve entegrasyonlarla birlikte kullanılabilmesi için YOURLS uyumlu bir API uç noktası sağlar.

Bu uç nokta, YOURLS'tan geçişi kolaylaştırmak veya S.EE'yi halihazırda YOURLS API protokolünü kullanan otomasyon araçlarına, tarayıcı uzantılarına ve uygulamalara entegre etmek için tasarlanmıştır.

API uç noktası

https://s.ee/api/v1/yourls

Uyumluluk kapsamı

Bu uç nokta kısmi bir YOURLS API uyumluluk katmanı uygular.

Desteklenenler

action=shorturl
signature ile kimlik doğrulama
Çıktı biçimleri: json, jsonp, xml, simple
GET ve POST istekleri

Desteklenmeyenler

username / password ile kimlik doğrulama
expand, stats veya db-stats gibi diğer YOURLS eylemleri
Yönetim veya veritabanı odaklı işlemler

Yalnızca URL kısaltma işlevi sunulur.

Kimlik doğrulama

Yalnızca signature ile kimlik doğrulama desteklenir. Kullanıcı adı/parola ile kimlik doğrulama desteklenmez.

signature parametresi sizin S.EE API anahtarı令牌 değerinizi temsil eder.

API anahtarı令牌'ınızı şu adresten oluşturabilir ve yönetebilirsiniz:

https://s.ee/user/developers/

API anahtarı令牌, doğrulanan kullanıcıya bağlıdır ve hesabın sahip olduğu izinleri ve kısıtlamaları aynen devralır.

Desteklenen eylemler

Şu anda yalnızca aşağıdaki eylem desteklenmektedir:

Eylem	Açıklama
`shorturl`	Verilen bağlantı için kısa URL oluşturur

Parametreler

Parametre	Gerekli	Açıklama
`signature`	Evet	S.EE API anahtarı令牌'ınız
`action`	Evet	Yapılacak işlem; şu anda yalnızca `shorturl`
`url`	Evet	Kısaltılacak URL
`format`	Hayır	Çıktı biçimi: `json`, `jsonp`, `xml` veya `simple`; varsayılan `simple`
`keyword`	Hayır	Kısa URL için özel slug
`title`	Hayır	Kısa URL başlığı

Notlar

Verilen keyword kullanımda ise API hata döndürmek yerine otomatik olarak yeni ve uygun bir keyword üretir
Tüm isteklerde S.EE'nin standart kötüye kullanım önleme ve doğrulama kuralları geçerlidir

Örnekler

POST isteği

curl -X POST \
  'https://s.ee/api/v1/yourls' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'signature=your_api_token' \
  --data-urlencode 'format=json' \
  --data-urlencode 'action=shorturl' \
  --data-urlencode 'url=https://example.com/'

Yanıt:

{
  "status": "success",
  "code": "",
  "message": "https://example.com/ added to database",
  "errorCode": "",
  "statusCode": "200",
  "url": {
    "keyword": "link",
    "url": "https://example.com/",
    "title": "",
    "date": "2026-01-14 21:38:10",
    "ip": "192.0.2.2"
  },
  "shorturl": "https://s.ee/link"
}

Bazı yanıt alanları YOURLS uyumluluğu için korunur ve boş olabilir.

GET isteği

curl -X GET "https://s.ee/api/v1/yourls?action=shorturl&format=simple&signature=your_api_token&url=https://example.com/"

Yanıt:

https://s.ee/link

GET isteklerinde parametreleri URL-encode etmeyi unutmayın. Uzun URL'ler veya ek parametreler için URL uzunluğu sınırlarından kaçınmak amacıyla POST kullanmanız önerilir.

Üçüncü taraf istemciler

Bu API, YOURLS tarzı URL kısaltmayı destekleyen tüm istemcilerle uyumludur:

Tarayıcı uzantıları
Mobil uygulamalar
Masaüstü uygulamaları
Otomasyon araçları (Shortcuts, Tasker, Zapier vb.)

YOURLS API belirtiminin özgün ayrıntıları için resmî dokümantasyona bakın:

https://yourls.org/readme.html#API

YOURLS uyumlu API

Bu sayfada