---
title: "Guides"
url: "https://thy-portal.apim.eu/guides"
image: "https://thy-portal.apim.eu/_og/d/c_Ocean.takumi,title_Guides,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiNlODE5MzIifX19,p_Ii9ndWlkZXMi,s_tHNaqsrr8AbwOyIs.png"
---

# Guides

Practical guides for teams building on the Turkish Airlines API platform — how to document an API so others can consume it, how to publish it to this portal, and how to version it without breaking the integrations that already depend on it.

Document APIs

An API that is not documented is an API nobody can adopt. This guide covers how Turkish Airlines teams describe their services so that the specification itself — not a wiki page or a Slack thread — becomes the contract consumers build against.

[Read guide](https://thy-portal.apim.eu/document-apis)

Publish APIs

Publishing puts your API in front of consumers — internal teams, travel partners, and third-party developers. This guide covers what has to be true before you publish, and what changes the moment you do.

[Read guide](https://thy-portal.apim.eu/publish-apis)

API Versioning

Once an API is published, someone depends on it. Versioning is how Turkish Airlines evolves a service without breaking the integrations already in production — and how consumers know, ahead of time, what is about to change.

[Read guide](https://thy-portal.apim.eu/versioning)

## Frequently asked questions

How do I authenticate against the Turkish Airlines APIs?

Every API on this portal is protected by OpenID Connect. Register an application to receive a client ID and secret, exchange them at the token endpoint for a bearer token, then send that token in the Authorization header on every request. Tokens are short-lived — refresh them rather than caching them indefinitely.

What happens when an API changes?

Breaking changes ship as a new major version with its own path, and both versions run side by side through a published deprecation window. Non-breaking additions land in place. Version and deprecation notices are announced on this portal and sent to the owner of every registered application.

Ready to explore the full API catalog?

Browse interactive API documentation and start building.

[Browse APIs](https://thy-portal.apim.eu/apis)