Torna in cima 

Turkishexportal for Developers

API - Piattaforma per sviluppatori

Crea una potente applicazione con 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 .

    Concetti basilari

    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.

    richieste

      risposte

        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;

    Risposta Tipi

    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.",    
    .
    .
    }
}

    parametri

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

    Nome Codice Descrizione
    TL 04 Assistente Export & Sales Manager
    05 Assistente Export Manager
    06 assistente al direttore generale
    10 Assistant Sales Manager
    100
    101 Direttore generale
    103 International Marketing Assistant
    104 Marketing Manager Internazionale
    109 Sales Manager Internazionale
    116 Manager
    118 Consigliere delegato
    123 Marketing & Sales Representative
    128 Marketing Manager
    129 Rappresentante del Marketing
    13 Business Development Manager
    139 Proprietario
    14 Business Development Specialist
    143 Compagno
    160 Rappresentante
    161 Sales & Export Director
    162 Sales & Export Manager
    164 Sales & Marketing Manager
    17 Amministratore delegato
    170 Direttore delle vendite
    171 Rappresentante commerciale
    35 Direttore
    36 Direttore del Business Development
    37 Direttore Della Export & Import
    38 Director of Sales & Logistics
    46 Export & Import Assistant
    48 Export & Import Manager
    49 Export & Import Rappresentante
    62 direttore Export
    65 Responsabile delle esportazioni
    69 Export rappresentante
    72 Export Sales Representative
    82 Sales Manager esteri
    83 Sales Representative esteri
    92 Manager per il commercio estero
    95 Foreign Trade Representative
    98 Fondatore / Direttore
    99
    Nome Codice Descrizione
    ER 01 1 -10
    02 10 - 50
    03 50 - 100
    04 100 - 250
    05 > 250

    Codice d'accesso

    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.

    Lista dei metodi

    Company

    Update
    Campo Descrizione genere
    name Nome della ditta 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>

    Elenco errori

    Codice Descrizione
    100 Nessun record trovato
    110 Si prega di verificare i campi non validi.
    255 C'è stato un'errore.

    Esecuzione del codice