Вернуться к началу 

Туркишэкспорт для разработчиков

API - Платформа разработчика

Создать мощное приложение с Turkishexportal.

The API provides the site members with the ability to access and manipulate the desired data from the platform. The API functions provide an infrastructure that can be easily implemented between any application or website and Turkishexportal . Many of the actions that members perform on the site, such as company update, add / modify / delete products, add / change / delete news and references, read / reply / delete messages, visitor reports are also available to users via API . API accepts requests in the form REST and accepts multiple respond

Some information about using the API ;

    For any issues with API , you can contact us at info@turkishexportal.com .

    Основные понятия

    The Basics Concepts page's API requirements are important to include error codes, general information, etc. We recommend starting with this section for the API . In the next stage, you can see the here methods you can use on the API . Finally, you should get a access code to integrate your API into your application.

    Запросы

      Ответы

        Paging

        This allows the data to be sent in handleable sizes for requests that list count , page and current parameters. Things to consider in lists;

    Типы ответов

    Turkishexportal API can send responses in 2 different formats;

      How to Determine the Response Type

      The type of response to be received is provided by the format parameter in the submitted request. When this parameter is not sent, the response is returned as standard JSON type. If you want to change it, you can specify the response type for each request by adding the format = xml or format = json parameter.

      XML

      XML responses are in a special XML format specified by Turkishexportal.

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

      Sample request - Truncated

      <?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 ) is a simple and useful data declaration format. It is used extensively in Ajax applications, especially those used within the browser.

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

      Sample request - Truncated

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

    параметры

    The parameters in this page are also used from time to time in definitions in the portal.

    название Код Описание
    TL 04 Помощник Экспорт & Менеджер по продажам
    05 Помощник Менеджер по экспорту
    06 Помощник Генерального менеджера
    10 Помощник менеджера по продажам
    100
    101 Главный управляющий
    103 Международный помощник по маркетингу
    104 Международный менеджер по маркетингу
    109 Менеджер по международным продажам
    116 Менеджер
    118 Управляющий директор
    123 Маркетинг и торговый представитель
    128 Менеджер по маркетингу
    129 представитель по маркетингу
    13 Менеджер по развитию бизнеса
    139 владелец
    14 Специалист по развитию бизнеса
    143 партнер
    160 представитель
    161 Менеджер по продажам и директор по экспорту
    162 Менеджер по продажам и менеджер по экспорту
    164 менеджер по продажам и маркетингу
    17 Исполнительный директор
    170 Менеджер по продажам
    171 Торговый представитель
    35 директор
    36 Директор по развитию бизнеса
    37 Директор по экспорту и импорту
    38 Директор по продажам & Logistics
    46 Помощник Экспорт & Импорт
    48 Менеджер Экспорт & Импорт
    49 Представитель Экспорт & Импорт
    62 директор по экспорту
    65 Менеджер по экспорту
    69 Экспорт представитель
    72 Экспорт Торговый представитель
    82 Менеджер по продажам иностранных
    83 Представитель зарубежных продаж
    92 Менеджер внешней торговли
    95 Внешнеторговая представитель
    98 Основатель / Менеджер
    99
    название Код Описание
    ER 01 1 -10
    02 10 - 50
    03 50 - 100
    04 100 - 250
    05 > 250

    Код доступа

    All access should be sent in the all requests apikey field via the Turkishexport API . Please keep your access code in a safe place. Keep in mind that your data security will be compromised if you have the code provided within your membership. In such cases, you must ensure that your code is canceled by contacting info@turkishexportal.com via email. A sample request with API Access Code is shown below.

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

    The apikey used in the above example is not a valid access code. It is given only in terms of being an example. Please use the apikey API Access Code assigned specifically to you in your own application.

    Список методов

    Company

    Update
    поле Описание Тип
    name название компании 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>

    Список ошибок

    Код Описание
    100 Запись не найдена
    110 Пожалуйста, проверьте неправильные поля.
    255 Произошла ошибка.

    Выполнение кода