Pegasus Hava Yolları API & XML Entegrasyonu Rehberi

Pegasus Hava Yolları'nın API'si, uçuş bilgileri, rezervasyon, biletleme ve check-in gibi hizmetlere erişim sağlar. Pegasus API entegrasyonunu adım adım nasıl gerçekleştirebileceğinizi öğreneceğiz.

Giriş

API (Application Programming Interface), yazılım uygulamalarının birbiriyle iletişim kurmasını sağlayan araçlardır. Pegasus Hava Yolları'nın API'si, uçuş bilgileri, rezervasyon, biletleme ve check-in gibi hizmetlere erişim sağlar. Bu yazıda, Pegasus API entegrasyonunu adım adım nasıl gerçekleştirebileceğinizi öğreneceksiniz.

Tüm hayayolu firmalarıyla entegre tek bir API istiyacınız var ise, Demircode firmasının FAPI (Flight API) ürününe göz atmak için tıklayın.

1. API'ye Erişim Sağlama

a. Kayıt ve API Anahtarı Alma

Pegasus API'sine erişmek için öncelikle Pegasus Developer Portal’a (https://devportal.flypgs.com/) kayıt olmanız gerekmektedir. Kayıt işlemini tamamladıktan sonra, API anahtarınızı alabilirsiniz.

b. API Dokümantasyonunu İnceleme

API anahtarını aldıktan sonra, Pegasus API dokümantasyonunu dikkatlice inceleyin. Dokümantasyon, kullanabileceğiniz uç noktalar (endpoints), istek ve yanıt formatları hakkında ayrıntılı bilgiler sağlar.

2. Temel Entegrasyon Adımları

a. Gerekli Kütüphanelerin Kurulumu

API entegrasyonu için bazı kütüphanelere ihtiyacınız olacak. Python örneği için:

pip install requests

b. API Anahtarı ile Kimlik Doğrulama

Pegasus API'sine istek göndermek için, API anahtarınızı kullanarak kimlik doğrulaması yapmanız gerekir. Aşağıdaki örnekte, bir uçuş sorgulaması yapılmaktadır:

import requests API_KEY = 'SİZİN_API_ANAHTARINIZ' headers = { 'Authorization': f'Bearer {API_KEY}' } response = requests.get('https://api.flypgs.com/flight-status', headers=headers) print(response.json())

3. Uç Noktaların Kullanımı

a. Uçuş Bilgileri Sorgulama

Uçuş bilgilerini sorgulamak için flight-status uç noktasını kullanabilirsiniz. İstek formatı ve parametreler dokümantasyonda belirtilmiştir.

b. Rezervasyon Yapma

Rezervasyon yapmak için gerekli olan uç nokta ve parametreler, yine API dokümantasyonunda detaylı bir şekilde açıklanmıştır. Örnek bir rezervasyon isteği:

data = { "flightNumber": "PC123", "date": "2024-07-11", "passengerInfo": [ { "firstName": "John", "lastName": "Doe", "passportNumber": "123456789" } ] } response = requests.post('https://api.flypgs.com/reservation', headers=headers, json=data) print(response.json())

c. Biletleme ve Check-in

Biletleme ve check-in işlemleri için de benzer şekilde ilgili uç noktaları kullanarak istek gönderebilirsiniz. Parametrelerin doğruluğuna ve zorunlu alanlara dikkat etmek önemlidir.

4. Hata Yönetimi ve Debugging

a. Hata Kodları ve Anlamları

API isteği sırasında karşılaşabileceğiniz hata kodlarını ve anlamlarını bilmek, sorunları hızlıca çözmenizi sağlar. Örneğin, 401 Unauthorized hatası genellikle yanlış veya eksik API anahtarından kaynaklanır.

b. Loglama

Entegrasyon sırasında loglama yaparak, hangi adımda hata aldığınızı kolayca tespit edebilirsiniz.

import logging logging.basicConfig(level=logging.INFO) try: response = requests.get('https://api.flypgs.com/flight-status', headers=headers) response.raise_for_status() logging.info(response.json()) except requests.exceptions.HTTPError as err: logging.error(f'HTTP error occurred: {err}') except Exception as err: logging.error(f'Other error occurred: {err}')

5. Performans ve Güvenlik İpuçları

a. İstek Sayısını Optimize Etme

API çağrılarınızı optimize ederek performansı artırabilirsiniz. Mümkün olduğunca toplu istekler yapmaya çalışın.

b. Güvenlik Önlemleri

API anahtarınızı güvende tutun ve sadece güvenli bağlantılar (https) kullanın. Anahtarınızı kod içerisine hardcode etmekten kaçının, çevresel değişkenler veya güvenli bir saklama yöntemi kullanın.

import os API_KEY = os.getenv('PEGASUS_API_KEY') headers = { 'Authorization': f'Bearer {API_KEY}' }

Sonuç

Pegasus API entegrasyonu, uçuş bilgileri, rezervasyon ve biletleme gibi işlemleri otomatikleştirmenizi sağlar. Bu rehberde, temel entegrasyon adımlarından hata yönetimine kadar çeşitli konuları ele aldık. Başarılı bir entegrasyon için, API dokümantasyonunu dikkatlice incelemeniz ve güvenlik önlemlerini almanız önemlidir.