EGGSY's API

EGGSY's Ücretsiz API Ayarları


Tanıtım

Öncelikle, API konusunda çok büyük katkıları olduğu için Tresmos'a ve bugüne kadar yanımda durup botu bu derece yukarılara çıkartan tüm kullanıcılarıma buradan sonsuz teşekkür ediyorum.

Bu sayfada bulacağınız şeyler, eğer kendi botunuzda veya web uygulamalarınızda kullanmayacaksanız işinize yaramayacaktır. Bu yüzden lütfen ne yaptığınızı bildiğinize emin olun ve işlemleri güzelce takip edin. Bu sayfadan botta kullanılan, aslen sitemize bağlı, kendi arşivimizde tuttuğumuz esprileri ve Atatürk fotoğraflarına nasıl erişim sağlayıp kendi uygulamalarınızda kullanabileceğiniz göreceksiniz. Bu sayede zorluk çekmeden kendiniz bir uygulama kurabilir ve bizim gibi sizde çalışabilirsiniz.

Gerekli Olan Şeyler

Bu komutları kullanabilmek için birkaç şeye ihtiyacınız olacak.

  1. Kod düzenleme editörü, mümkünse bilindik editörler; Visual Studio Code, Atom (Notepad++ tavsiye etmiyorum).
  2. Bir bot veya web uygulaması.
  3. Bilgi; en önemlisi. Burada ne yaptığınızı bilmiyorsanız emin olun burada işiniz yok.

Başlayalım! #başa dön

Bu site, elimizdeki bir çok yerel arşivin nasıl kullanılacağı hakkında basit bilgiler verecektir. Bu bilgileri öğrendikten sonra ileride çıkaracağımız diğer sistemleri de rahatlıkla anlayabileceksiniz. Elimizde bulunan espri ve Atatürk resimleri arşivi kendi botumuza özel, sitemizdeki gizli bir kaynaktan alınıyor. Bu sayfadan ise o kaynağa ulaşarak, rastgele fotoğraflar aldırabileceksiniz. Tek yapmanız gereken örnekleri takip ederek uygulamanıza düzgün bir şekilde yerleştirmek. Hadi bakalım!

Çalışma Mantığı

İstek Sonuç Açıklama
/ataturk link: Rastgele Atatürk resimlerini "link" içerisinde gönderir.
/espri soz: Rastgele esprileri "soz" içerisinde gönderir.

Atatürk fotoğrafları için /ataturk üzerinden istek gönderdiğinizde, API hizmeti size JSON formatında bir sonuç gönderecektir. Bu formatı Discord botlarınızda ve web uygulamalarınızda rahatlıkla kullanabileceksiniz. JSON'da, her yeni isteğe yeni bir Atatürk resminin olduğu "link" içerisine linkler gösterilecektir.

Espriler için /espri üzerinden istek gönderildiğinde API hizmeti sizlere her yeni istekte farklı espriler gönderecektir. JSON formatında olan bu esprileri ise aynı şekilde, basitçe uygulamalarınızda kullanabilirsiniz. Espriler JSON formatında "soz'un içerisinde olacaktır.

Örnekler #başa dön

Mantık oldukça basit bir derecede işliyor; isteği gönderiyorsunuz, site size JSON formatında cevap veriyor, siz ise bu cevabı alıp kendi uygulamalarınızda kullanabiliyorsunuz; güzel, değil mi? İsteği yapmak için JavaScript ve discord.js dillerinde bir modüle ihtiyaç duyabilirsiniz. Aşağıdaki örnekte "request" modülü kullanıldı. Modül, siteye ulaşıp isteği attıktan sonra siteden aldığı cevabı işleyecek ve size ulaştıracaktır. Aşağıdaki örneklere bakarak daha fazla bilgi alabilirsiniz.

Rastgele Atatürk Resimleri Örneği

var request = require('request');

request('https://api.eggsybot.xyz/ataturk', function (error, response, body) {
    if (error) return console.log('Hata:', error); // Hata olursa, konsola göndersin,
    else if (!error) { // Eğer hata yoksa;
        var info = JSON.parse(body); // info değişkeninin içerisine JSON'ı ayrıştırsın,
        console.log(info.link); // ve konsola çıktıyı versin.
    }
});

Yukarıdaki işlem, "/ataturk" adresine istek gönderecek ve oradan aldığı sonucu info değişkeninde ayrıştıracaktır. Ayrıştırma sonrasında JSON formatında kullanılan yolları kullanabileceksiniz. Yukarıdaki tabloda belirtilen "Sonuç" bölümü, size yolu göstermektedir. Yani, rastgele Atatürk resimlerinde sonuç "link" olduğu için JSON yolu info.link olacaktır. Eğer siz sonucu (linki) konsola yazdırmak yerine mesaj kanalına göndermek istiyorsanız koddaki:

...
    console.log(info.link);
...
kısmını,
...
    msg.channel.send(info.link);
...
olarak değiştirmelisiniz.

Rastgele Espri Örneği

var request = require('request');

request('https://api.eggsybot.xyz/espri', function (error, response, body) {
    if (error) return console.log('Hata:', error); // Hata olursa, konsola göndersin,
    else if (!error) { // Eğer hata yoksa;
        var info = JSON.parse(body); // info değişkeninin içerisine JSON'ı ayrıştırsın,
        console.log(info.soz); // ve konsola çıktıyı versin.
    }
});

Yukarıdaki örnek ise önceki Atatürk örneği ile birebir aynı. Sadece, modül bu sefer "/espri" adresine istek gönderiyor ve sonucu oradan alıor. Tablodaki verilere baktığımızda "/espri'nin sonucunun soz olduğunu görüyoruz. Bu da demek oluyor ki JSON'ı ayrıştırdığımız sonra "soz" gelecek. Eğer konsol yerine mesaj kanalına göndermek istiyorsanız Atatürk örneğinde olduğu gibi bunda da o şekilde ufak bir değişiklik yaparak isteğinizi gerçekleştirebilirsiniz.

Bu sitenin tasarımı başka bir yapımcıdan alınıp üzerinde değişiklikler yaparak bu hâle getirilmiştir. Herhangi bir hak talebi yoktur.
Gördüğünüz herhangi bir hatada (geçersiz resim, yanlış veya uyumsuz espri vs.) sitemize mail atmaktan çekinmeyin.
EGGSY's Bot 2017 -
Siteye Geri Dön