API - Geliştirme Platformu

 

Turkishexportal ile güçlü bir uygulama oluşturun.

Turkishexportal Uygulama Programlama Arayüzü (API), site üyelerine, istedikleri platformdan verilerine ulaşıp üzerinde işlem yapabilme imkanını verir. API fonksiyonları, herhangi bir uygulama veya internet sitesi ile Turkishexportal arasında kolayca uygulanabilecek bir altyapı sunar. Üyelerin site üzerinde gerçekleştirdiği firma güncelleme, ürün ekleme / değiştirme / silme, haber ve referans ekleme / değiştirme / silme, mesajları okuma / yanıtlama / silme, ziyaretçi raporları gibi işlemlerin çoğu API aracılığıyla da kullanıcıların hizmetine sunulmaktadır. API REST biçiminde talepleri kabul edip birden çok yanıt

API kullanımıyla ilgili bazı bilgiler ;

    API ile ilgili her türlü sorunuz için bizimle info@turkishexportal.com e-posta adresi ile iletişime geçebilirsiniz.

    Temel Kavramlar

    Temel Kavramlar sayfası API kullanımına dair gereksinimleri, genel bilgileri, hata kodlarını içermesi açısından önemlidir.

    İstekler

      Yanıtlar

        Sayfalama

        count, page ve current parametreleri listeleme tarzı isteklerde gönderilecek verinin işlenebilir boyutta olmasını sağlar. Listelemelerde dikkat edilmesi gereken hususlar ;

    Yanıt Tipleri

    Turkishexportal API 2 farklı biçimde yanıt gönderebilir ;

      Yanıt Tipi Nasıl Belirlenir ?

      Alınmak istenen yanıt tipi gönderilen istek içindeki format parametresi ile sağlanır. Bu parameterenin gönderilmediği durumlarda standart olarak JSON

      XML

      XML yanıtları Turkishexportal tarafından belirlenmiş özel bir XML biçimindedir.

      https://www.turkishexportal.com/api/1.0/company/select?key=123&type=xml

      Örnek istek - Kesilmiş

      <?xml version="1.0"?>
      <Company xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <accountype>F</accountype>
        <active>Y</active>
        <alias>test</alias>
        <businesstype>01</businesstype>
        <communication>
          <address1>Ahmet Sokak. Aykon Apt.</address1>
      	.
      	.
      	.
      </Company>
      

      JSON

      JSON (JavaScript Object Notation, json.org) basit ve kullanışlı veri bildirim biçimidir. Özellikle tarayıcı içinden kullanılacak Ajax uygulamalarında yoğun biçimde kullanılır.

      https://www.turkishexportal.com/api/1.0/company/select?key=123&type=json

      Örnek istek - Kesilmiş

      {
          "accountype":"F",
          "active":"Y",
          "alias":"test",
          "businesstype":"01",
          "communication":{  
              "address1":"Ahmet Sokak. Aykon Apt.",    
          .
          .
          }
      }
      

    Parametreler

    Portal içinde tanımlamalarda zaman zaman bu sayfadaki parametereler de kullanılmaktadır.

    İsim Kod Açıklama
    TL 04 İhracat ve Satış Müdürü Yardımcısı
    05 İhracat Müdürü Yardımcısı
    06 Genel Müdür Yardımcısı
    10 Satış Müdürü Yardımcısı
    100 Mühendis
    101 Genel Müdür
    103 Uluslararası Pazarlama Yardımcısı
    104 Uluslararası Pazarlama Müdürü
    109 Uluslararası Satış Müdürü
    116 Müdür
    118 Yönetici Direktör
    123 Pazarlama ve Satış Temsilcisi
    128 Pazarlama Müdürü
    129 Pazarlama Temsilcisi
    13 İş Geliştirme Müdürü
    139 Firma Sahibi
    14 İş Geliştirme Uzmanı
    143 Ortak
    160 Temsilci
    161 Satış ve İhracat Direktörü
    162 Satış ve İhracat Müdürü
    164 Satış ve Pazarlama Müdürü
    17 CEO
    170 Satış Müdürü
    171 Satış Temsilcisi
    35 Direktör
    36 İş Geliştirme Direktörü
    37 İthalat İhracat Direktörü
    38 Satış ve Lojistik Direktörü
    46 İhracat ve İthalat Yardımcısı
    48 İhracat ve İthalat Müdürü
    49 İhracat ve İthalat Temsilcisi
    62 İhracat Direktörü
    65 İhracat Müdürü
    69 İhracat Temsilcisi
    72 İhracat Satış Temsilcisi
    82 Yurt Dışı Satış Müdürü
    83 Yurt Dışı Satış Temsilcisi
    92 Dış Ticaret Müdürü
    95 Dış Ticaret Temsilcisi
    98 Kurucu / Müdür
    99 Ar-Ge Mühendisi
    İsim Kod Açıklama
    ER 01 1 - 10
    02 10 - 50
    03 50 - 100
    04 100 - 250
    05 > 250

    Erişim Kodu

    Turkishexport API aracılığıyla yapılan tüm isteklerde apikey alanında doğru ve geçerli bir erişim kodu gönderilmelidir. Erişim kodunuzu lütfen güvenli bir ortamda saklayınız. Üyeliğiniz dahilinde verilen

    https://www.turkishexportal.com/api/1.0/company/select?format=xml&apikey=f893a3bf3cfc432a8e304f07e5ea11f5

    Yukarıdaki örnekte kullanılan apikey geçerli bir erişim kodu değildir. Sadece örnek olması açısından verilmiştir. Lütfen kendi uygulamanızda size özel tahsis edilen apikey API Erişim Kodunu kullanınız.

    Metot Listesi

    Company

    Update
    Alan Açıklama Tip
    name Şirket Adı Varchar [100]
    <?xml version="1.0"?>
    <Company xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <uid>33d27f2c6ed0403f98ab0219e3fec20e</uid>
      <name>Test Co Ltd.</name>
      <history>Test is the company that provides the best product.</history>
      <email>info@test.com</email>
      <mf>M</mf>
      <representative>Test Person</representative>
      <establishdate>1965</establishdate>
      <businesstype>01</businesstype>
      <statistic>
        <itemscount>4</itemscount>
        <newscount>1</newscount>
        <referencecount>1</referencecount>
        <certificatecount>2</certificatecount>
      </statistic>
    </Company>

    Hata Listesi

    Kod Açıklama
    100 Kayıt Bulunamadı
    110 Lütfen geçersiz alanları kontrol ediniz.
    255 Hata oluştu.

    Kod Çalıştırma

 

En Üste Git