Geliştirici

Burada yeni Kisalt.GQ API'sinin nasıl kullanılacağını anlatacağım. Geliştiricilerin isteklerini kolaylaştırmak için API'de bazı değişiklikler oldu.

 

API Anahtarı için Kaydetme
Daha önce olduğu gibi, isteklerin sistem tarafından işlenmesi için bir API anahtarı gerekir. Bir kullanıcı kaydolduğunda, bu kullanıcı için otomatik olarak bir API anahtarı oluşturulur. API anahtarının, api parametresi üzerinden istekte bulunması gerekir (aşağıdaki tam örneğe bakın).

 

URL kısaltmak için istek gönderme
Bir istek göndermek için, kullanıcı api ve url değişkenlerinin gerekli olduğu aşağıdaki formatı kullanmalıdır. Aşağıdaki örnekte demonun URL'si kullanılmış ancak kendi alan adınızı kullanmalısınız. Özel bir takma ad istemek için, sonuna & custom = sonuna ekleyin.

  Https://kisalt.gq/short/api?api=APIKEY&url=THELONGURLTOBESHORTENED&custom=CUSTOMALIAS


Sunucu yanıtı
Daha önce olduğu gibi, yanıt JSON formatında kodlanacaktır (varsayılan). Bu, diller arası kullanımı kolaylaştırmak için yapılır. Yanıtın ilk elemanı her zaman bir hatanın meydana gelip gelmediğini (hata: 1) ya da olmadığını (hata: 0) söyleyecektir. İkinci element, birinci elemana göre değişecektir. Bir hata varsa, ikinci eleman “msg” olarak adlandırılır. hata kaynağını içeren, aksi takdirde kısa URL'yi içeren “short” olarak adlandırılır. (Örnek için aşağıya bakın)

// No errors
{
  "error":0,
  "short":"http:\/\/kisalt.gq\/short\/DkZOb"
}
// An error has occurred
{
  "error":1,
  "msg":"geçerli e-posta girin"
}

Düz metin biçimini kullanma
Artık isteğinizin sonuna & format = text ekleyerek yanıtın düz metin olmasını isteyebilirsiniz. Bu, JSON yanıtı yerine yalnızca http://gempixel.com/short/DkZOb döndürür. Bir hata oluşursa, hiçbir şey çıkmayacağını unutmayın.

 

PHP’de API’yi kullanma
API'yı PHP uygulamanızda kullanmak için, file_get_contents veya cURL aracılığıyla bir GET isteği göndermelisiniz: Her ikisi de güvenilir yöntemlerdir. File_get_contents'ı kullanarak aşağıdaki örnek kodu görebilirsiniz.