Hello and Welcome on Board!

Hello and Welcome on Board!

With our open API platform, we provide you the chance to reach, test and use Turkish Airlines’s digital services. Using these, you now have the power of Turkish Airlines supporting you to develop the future. Let’s look how you can do it ;

Getting Started :

1. Sign up for a TK Developer account

*(If you already have an account, go to log in page – and jump to step 2)

  • Go to our
  • Complete the registration and create an account.

You now have access to your dashboard. From here you can create and configure your apps.

2. Create an app
In your Dashboard, click Applications tab.

 

  • Because there are no applications that you created yet, you have to Add an Application first.



     
  • In the Application Information tab; you have to specify your application’s name and on which platform your application is going to be running.




     
  • In API Management tab; you will choose the API(s) that you are going to be using in your application.




     
  • In the Auth tab; fields are optional.




     
  • After you click Save button, you will see your application in the Applications tab.




     
  • After you click Edit, You can see your ApiKey/ApiSecret under Auth tab.


     

3. Test the application

  • In our API Explorer page, you can test the APIs using your API Key/Api Secret.
  • You can also test any API in documentation page.
  • Select application you created

     
  • Select Service Authentication as API Key.Corresponding fields should be filled automatically.



     
  • You should add your API Secret with Add Parameter option



     

4. Publish your Application

You can contact Turkish Airlines API Portal  Crew to publish your application.

5. Common Error Codes

Common error messages that can be received from APIs are listed below.

Error Messages

Http Status Code Message Code Description

400

4002 Request is not a valid JSON

400

4003 Unallowed request structure

400

- Invalid API Key

400

- Invalid API Secret

401

TK1001 401 UNAUTHORIZED

403

TK1002 403 FORBIDDEN

404

TK1006 404 NOT FOUND

500

TK1003 500 INTERNAL SERVER ERROR

504

TK1004 Connection Timeout

504

TK1005 Read Timeout