Turkishexportal for Developers
API - Developer Platform
Kreirajte moćnu aplikaciju sa 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 .
Basic Concepts
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.
Zahtjevi
Responses
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;
Vrste odgovora
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.
Ime | Kod | Opis |
---|---|---|
TL | 04 | Pomoćnik izvoznog i prodajnog menadžera |
05 | Pomoćnik izvoznog menadžera | |
06 | Pomoćnik generalnog direktora | |
10 | Pomoćnik direktora prodaje | |
100 | ||
101 | Generalni direktor | |
103 | International Marketing Assistant | |
104 | International Marketing Manager | |
109 | International Sales Manager | |
116 | Menadžer | |
118 | Direktor menadžmenta | |
123 | Marketing & Sales Representative | |
128 | Marketing menadžer | |
129 | Predstavnik za marketing | |
13 | Menadžer za razvoj poslovanja | |
139 | Vlasnik | |
14 | Specijalista za razvoj poslovanja | |
143 | Partner | |
160 | Predstavnik | |
161 | Direktor prodaje i izvoza | |
162 | Sales & Export Manager | |
164 | Sales & Marketing Manager | |
17 | CEO | |
170 | Sales Manager | |
171 | Predstavnik prodaje | |
35 | Direktor | |
36 | Direktor razvoja poslovanja | |
37 | Direktor izvoza i uvoza | |
38 | Direktor prodaje i logistike | |
46 | Pomoćnik za izvoz i uvoz | |
48 | Export & Import Manager | |
49 | Predstavnik za izvoz i uvoz | |
62 | Direktor izvoza | |
65 | Export Manager | |
69 | Export Representative | |
72 | Izvozni predstavnik | |
82 | Direktor prodaje u inostranstvu | |
83 | Predstavnik za spoljne poslove | |
92 | Foreign Trade Manager | |
95 | Predstavnik za vanjsku trgovinu | |
98 | Osnivač / Menadžer | |
99 |
Ime | Kod | Opis |
---|---|---|
ER | 01 | 1 -10 |
02 | 10 - 50 | |
03 | 50 - 100 | |
04 | 100 - 250 | |
05 | > 250 |
Pristupni kod
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 metoda
Company
Field | Opis | Tip |
---|---|---|
name | Ime kompanije | 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>
Lista grešaka
Kod | Opis |
---|---|
100 | Nema zapisa |
110 | Molimo provjerite nevažeća polja. |
255 | Došlo je do greške. |