API Kılavuzu
Yazılımcıların kendi projeleri için geliştirdiğimiz web servisimiz kullanım kolaylığı ve esnekliği açısından REST mimarisi ile geliştirilmektedir. Response ( Yanıt ) tipi sadece JSON’dur.
Bildiğiniz gibi Restful web servislerinde POST,PUT,DELETE,GET metotlarından sadece GET ve POST ile tüm işlemlerinizi halledebilirsiniz.
Restful Web Servisi için Bazı Kaynaklar :
https://en.wikipedia.org/wiki/Representational_state_transfer
https://tr.wikipedia.org/wiki/REST
ERİŞİM ANAHTARI OLUŞTURMA
- Üye girişi yapınız hesabınız yoksa Üye olunuz
- Panelim -> Geliştirici
- Erişim anahtarınız için ÖNEMLİ hususlar
1. Hizmet
2. Alan Adı
Sosyal paylaşım için oluşturduğunuz ERİŞİM ANAHTARINI farklı bir servis için kullanamazsınız ve “wrongKey” geçersiz anahtar hatasını alırsınız.
Alandınız HOST (Örn : fixerkit.com ) ismini olmalıdır. Fixerkit.com için oluşturduğunuz anahtarı istediğiniz subdomain veya alt klasorler için kullanabilirsiniz.
SERVİSLER
- Sosyal Paylaşım ( Social )
Önemli Not : Şuan için sadece Sosyal paylaşım servisi aktif durumdadır.
SERVİS HİYERARŞİSİ
Her GET ve POST işleminde oluşturduğunuz ERİŞİM ANAHTARINI ( Access Token ) bilgisini göndermeniz gerekmektedir.
Örn : /developer/social/listMessages?access_token=xxx
        // http://fixerkit.com/developer/ ( Servis Adı )/Metot Adı
        // Örn : /developer/social/listMessages

        $ch = curl_init("http://fixerkit.com/developer/social/listMessages?access_token=xxx");
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        $response = curl_exec($ch);
        curl_close($ch);
      
API METOTLARI KULLANIMLARI
Her servisin içinde bulunan tüm metotları listelemek için "getClassMethods" istediğinde bulunabilirsiniz.
Örn : /developer/social/getClassMethods
"getClassMethods" Metotu sayesinde istediğiniz serviste kullanabileceğiniz hangi methodlar mevcut, bunların kullanımlarını ve gereken argümanlarını bulabilirsiniz.
  • getAccounts
  • listMessages
  • getGroups
  • myLimit
  • send
  • edit
  • delete
getAccounts() » Sosyal medya hesap listesi
Örn : GET /developer/social/getAccounts
            // Örn : /developer/social/getAccounts

            $ch = curl_init("http://fixerkit.com/developer/social/getAccounts?access_token=xxx");
            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
            $response = curl_exec($ch);
            curl_close($ch);
          
listMessages() » Gönderilen mesajların listesi
Örn : GET /developer/social/listMessages
            // Örn : /developer/social/listMessages

            $ch = curl_init("http://fixerkit.com/developer/social/listMessages?access_token=xxx");
            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
            $response = curl_exec($ch);
            curl_close($ch);
          
getGroups() » Oluşturulmuş sosyal medya grup listesi
Örn : GET /developer/social/getGroups
            // Örn : /developer/social/getGroups

            $ch = curl_init("http://fixerkit.com/developer/social/getGroups?access_token=xxx");
            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
            $response = curl_exec($ch);
            curl_close($ch);
          
myLimit() » Kullanabilir limit ve kullanılan limitleri gösterir
Örn : GET /developer/social/myLimit
            // Örn : /developer/social/myLimit

            $ch = curl_init("http://fixerkit.com/developer/social/myLimit?access_token=xxx");
            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
            $response = curl_exec($ch);
            curl_close($ch);
          
send() » Sosyal medya mesajı gönderme işlemi
Örn : POST /developer/social/send
$_POST değerleri :
title
Gerekli
Max 250 Karakter
description
Gerekli
Max 2000 Karakter
group_id
Gerekli
Sayısıtal değer olmalıdır
link
İsteğe Bağlı
http:// ile başlamalıdır
image
İsteğe Bağlı
http:// ile başlamalıdır
              // Örn : /developer/social/send

              $post = array(
              "title" => "Fixerkit for Developers",
              "description" => "Fixerkit Ürün ve Hizmetleriniz için Analiz, Raporlama Ve Takip Etme",
              "group" => "0", /* or Group Id */
              "link" => "https://fixerkit.com/tr",
              "image" => "http://fixerkit.com/app/view/assets/images/logo.png",
              );

              $ch = curl_init("http://fixerkit.com/developer/social/send?access_token=xxx");
              curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
              curl_setopt($ch, CURLOPT_POSTFIELDS, $post);
              $response = curl_exec($ch);
              curl_close($ch);
            
edit() » Sosyal medya hesaplarınıza gönderdiğiniz mesajları düzenleme işlemi
Örn : POST /developer/social/edit/socialMessageId
socialMessageId : Fixerkit tarafından düzenlemek istediğiniz mesaja verilen benzersiz id
$_POST değerleri :
title
Gerekli
Max 250 Karakter
description
Gerekli
Max 2000 Karakter
group_id
Gerekli
Sayısıtal değer olmalıdır
link
İsteğe Bağlı
http:// ile başlamalıdır
image
İsteğe Bağlı
http:// ile başlamalıdır
              // Örn : /developer/social/edit/socialMessageId
              // socialMessageId : Fixerkit tarafından düzenlemek istediğiniz mesaja verilen benzersiz id

              $post = array(
              "title" => "Fixerkit for Developers",
              "description" => "Fixerkit Ürün ve Hizmetleriniz için Analiz, Raporlama Ve Takip Etme",
              "group" => "0", /* or Group Id */
              "link" => "https://fixerkit.com/tr",
              "image" => "http://fixerkit.com/app/view/assets/images/logo.png",
              );

              $ch = curl_init("http://fixerkit.com/developer/social/edit/socialMessageId?access_token=xxx");
              curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
              curl_setopt($ch, CURLOPT_POSTFIELDS, $post);
              $response = curl_exec($ch);
              curl_close($ch);
            
delete() » Sosyal medya hesaplarınıza gönderdiğiniz mesajları silme işlemi
Örn : GET /developer/social/edit/socialMessageId
socialMessageId : Fixerkit tarafından düzenlemek istediğiniz mesaja verilen benzersiz id
              // Örn : /developer/social/delete/socialMessageId
              // socialMessageId : Fixerkit tarafından düzenlemek istediğiniz mesaja verilen benzersiz id

              $ch = curl_init("http://fixerkit.com/developer/social/delete/socialMessageId?access_token=xxx");
              curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
              $response = curl_exec($ch);
              curl_close($ch);
            
EKLENTİLER
Fixerkit apisinin kullanımı ve hazır CMS sistemler için geliştirilen eklentiler mevcuttur.
Wordpress için geliştirilmiş kullanımda olan Sosyal Paylaşım apimizi kullanan Fixerkit Social Share Wordpress Plugin
Kullanım
/panel/developer Alanından Sosyal Paylaşım için Erişim Anahtarı oluşturunuz.
Eklentinizin ayarlar kısmından erişim antarını giriniz
Göndermek istediğiniz grubu seçiniz
Her içerik eklediğiniz wordpressteki içeriğinizi sizin adınıza seçtiğiniz grupta otomatik olarak paylaşacaktır.
İsterseniz kendiniz Sosyal Mesaj Gönder alanından mesaj gönderebilirsiniz.