> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Genel Bakış

> Apinizer API Developer Portal, API'lerinizi geliştiricilere ve partnerlere sunmak için kapsamlı bir platform sağlar. API kataloğu, dokümantasyon, self-service kayıt, API key yönetimi, analitik ve test araçları gibi özellikler sunar. API Portal'ın tanımlarını, temel kavramlarını, portal tiplerini ve Apinizer'ın API Portal yeteneklerini kapsar.

## API Developer Portal Nedir?

API Developer Portal (API Geliştirici Portalı), Apinizer API Gateway üzerinde yayınlanan API'lerinizi geliştiricilere, partnerlere ve son kullanıcılara sunmak için kullanılan kapsamlı bir self-service platformudur. Bu portal, API'lerinizi keşfedilebilir, dokümante edilmiş ve kolayca kullanılabilir hale getirerek API ekosisteminizi büyütmenizi sağlar.

### Temel İşlevler

API Developer Portal aşağıdaki temel işlevleri yerine getirir:

* **API Kataloğu**: API'lerinizi kategorize edilmiş, arama yapılabilir bir katalogda sunma
* **Self-Service Kayıt**: Geliştiricilerin kendi hesaplarını oluşturmasına ve API'lere abone olmasına izin verme
* **API Dokümantasyonu**: Otomatik ve manuel dokümantasyon ile API kullanımını kolaylaştırma
* **API Key Yönetimi**: Güvenli API erişimi için credential yönetimi
* **Fiyatlandırma ve Planlar**: Farklı kullanım planları ve monetizasyon stratejileri
* **Analytics ve İzleme**: API kullanım istatistikleri ve performans metrikleri
* **Test Araçları**: Portal üzerinden API'leri test etme imkanı
* **Görünürlük Kontrolü**: Public, Private ve Authorized Organizations bazlı erişim yönetimi

### Kullanım Senaryoları

* **Public API Portal**: Genel kullanıma açık API'leri sunma
* **Partner API Portal**: Belirli partner şirketlere özel API'leri sunma
* **Internal API Portal**: Kurum içi geliştiricilere API'leri sunma
* **API Monetizasyonu**: API kullanımından gelir elde etme
* **Developer Onboarding**: Yeni geliştiricileri hızlıca entegre etme
* **API Ekosistemini Büyütme**: Daha fazla geliştirici ve uygulama çekme

## Portal Tipleri

Apinizer API Portal, farklı kullanım senaryoları için esnek görünürlük ve erişim kontrolü sunar.

### Public API Portal (Herkese Açık Portal)

**Ne Zaman Kullanılır:**

* Genel kullanıma açık API'leri sunmak istediğinizde
* Mümkün olduğunca fazla geliştiriciye ulaşmak istediğinizde
* Açık API stratejisi izlediğinizde
* Marketing ve yaygınlaştırma odaklı olduğunuzda

**Özellikler:**

* Herkes portal'a kayıt olabilir
* Tüm yayınlanmış API'ler herkese görünür
* Self-service kayıt ve onay süreci
* Geniş kullanıcı tabanına erişim

**Kullanım Örnekleri:**

* Hava durumu API'leri
* Harita servisleri
* Genel veri API'leri
* Açık veri platformları

### Partner API Portal (Partner Portalı)

**Ne Zaman Kullanılır:**

* Belirli partner şirketlere özel API'leri sunmak istediğinizde
* B2B entegrasyonlar için API'leri paylaşmak istediğinizde
* Kontrollü erişim gerektiren API'ler için
* Kurumsal müşterilere özel çözümler sunmak istediğinizde

**Özellikler:**

* Sadece yetkili organizasyonlar erişebilir
* Organizasyon bazlı görünürlük kontrolü
* Partner bazlı özel planlar ve fiyatlandırma
* Gelişmiş güvenlik ve erişim kontrolü

**Kullanım Örnekleri:**

* Ödeme gateway entegrasyonları
* Kurumsal veri paylaşımı
* B2B servis entegrasyonları
* Özel partner çözümleri

### Internal API Portal (İç Portal)

**Ne Zaman Kullanılır:**

* Kurum içi geliştiricilere API'leri sunmak istediğinizde
* İç sistemler arası entegrasyon için
* Şirket içi API ekosistemini yönetmek istediğinizde
* Merkezi API yönetimi ve dokümantasyon için

**Özellikler:**

* Sadece kurum içi kullanıcılar erişebilir
* İç network üzerinden erişim
* Şirket kimlik doğrulama sistemi entegrasyonu
* İç kullanım odaklı planlar

**Kullanım Örnekleri:**

* Mikroservis API'leri
* İç sistem entegrasyonları
* Departmanlar arası API paylaşımı
* Kurumsal API kataloğu

## Apinizer API Portal Özellikleri

Apinizer API Portal aşağıdaki kapsamlı özellikleri sunar:

<CardGroup cols={2}>
  <Card title="API Ürün Yönetimi" icon="box">
    API'lerinizi ürün olarak paketleyin, kategorize edin ve yayınlayın. Farklı görünürlük seviyeleri ve planlar tanımlayın.
  </Card>

  <Card title="Self-Service Kayıt" icon="user-plus">
    Geliştiricilerin kendi hesaplarını oluşturmasına izin verin. Otomatik veya manuel onay süreçleri.
  </Card>

  <Card title="API Dokümantasyonu" icon="book">
    Otomatik OpenAPI/Swagger dokümantasyonu ve özel dokümantasyon sayfaları. Kod örnekleri ve kullanım kılavuzları.
  </Card>

  <Card title="API Key Yönetimi" icon="key">
    Güvenli credential oluşturma, rotasyon ve yönetimi. Uygulama bazlı API key'ler.
  </Card>

  <Card title="Fiyatlandırma Planları" icon="dollar-sign">
    Free, Subscription, Metered ve Tiered planlar. API monetizasyonu için esnek fiyatlandırma.
  </Card>

  <Card title="Test Araçları" icon="flask">
    Portal üzerinden API'leri test edin. Try It konsolu, JSONPath, XPath ve dönüştürme araçları.
  </Card>

  <Card title="Analytics ve İzleme" icon="chart-bar">
    API kullanım istatistikleri, trafik analizi ve performans metrikleri. Dashboard ve raporlar.
  </Card>

  <Card title="Organizasyon Yönetimi" icon="building">
    Organizasyon bazlı erişim kontrolü ve görünürlük yönetimi. Organizasyon yöneticileri.
  </Card>

  <Card title="Destek Paketleri" icon="headset">
    SLA seviyeleri, destek kanalları ve paket yönetimi. Destek talepleri ve Jira entegrasyonu.
  </Card>

  <Card title="Özelleştirilebilir Tema" icon="palette">
    Logo, renkler, fontlar ve HTML içeriklerle portal görünümünü özelleştirin.
  </Card>

  <Card title="Çoklu Dil Desteği" icon="language">
    Türkçe ve İngilizce dil desteği. Çoklu dil içerik yönetimi.
  </Card>

  <Card title="E-posta Bildirimleri" icon="envelope">
    Otomatik e-posta şablonları. Kayıt, onay, red ve bildirim e-postaları.
  </Card>
</CardGroup>

## Portal Modülleri

API Developer Portal aşağıdaki modüllerden oluşur:

### API Ürün Yönetimi

[API Ürünü](/tr/api-portal/api-urunu) modülü, API'lerinizi portal üzerinden son kullanıcılara sunmak için oluşturulup yayınlanabilir bir ürün haline getirir.

**Özellikler:**

* API Proxy veya Proxy Group'ları ürün olarak paketleme
* Kategori bazlı organizasyon
* Görünürlük kontrolü (Public, Private, Authorized Organizations)
* Fiyatlandırma planları (Free, Subscription, Metered, Tiered)
* Dokümantasyon ve dosya yönetimi
* Otomatik OpenAPI/Swagger entegrasyonu

### Hesaplar ve Geliştiriciler

[Hesaplar/Geliştiriciler](/tr/api-portal/hesaplar-gelistiriciler) modülü, portal kullanıcılarının ve geliştiricilerin yönetimini sağlar.

**Özellikler:**

* Self-service kayıt ve onay süreci
* Profil yönetimi
* Organizasyon yöneticisi yetkileri
* API Access Token oluşturma ve yönetimi
* Şifre yönetimi ve güvenlik

### Uygulama Yönetimi

[Uygulama Yönetimi](/tr/api-portal/uygulama-yonetimi) modülü, portal kullanıcılarının API'lere erişmek için oluşturdukları uygulamaları yönetir.

**Özellikler:**

* Portal App oluşturma ve yönetimi
* API Key (Credential) oluşturma ve rotasyon
* API Product abonelikleri
* Uygulama bazlı kullanım izleme

### Portal Ayarları

[API Portal](/tr/api-portal/api-portal-ayarlari) modülü, portal'ın temel konfigürasyonlarını yönetir.

**Özellikler:**

* Genel ayarlar (ad, URL, dil)
* E-posta bildirimleri ve şablonları
* Güvenlik ayarları (kayıt, onay, credential yönetimi)
* Özellikler (Test Tools, Analytics, Jira entegrasyonu)
* Yasal düzenlemeler ve SEO

### Görünüm ve Tema

[Görünüm ve Tema](/tr/api-portal/gorunum-tema) modülü, portal'ın görsel kimliğini özelleştirmenizi sağlar.

**Özellikler:**

* Logo ve favicon yönetimi
* Renk paleti ve tema ayarları
* Ana sayfa içerikleri
* Footer ve "Nasıl Çalışır" sayfası
* Çoklu dil içerik yönetimi

### Test Araçları

[Araçlar](/tr/api-portal/araclar) modülü, portal kullanıcılarına çeşitli test ve dönüştürme araçları sunar.

**Özellikler:**

* JSONPath testi
* XPath testi
* XML/JSON dönüştürme
* Base64 encode/decode
* JWT decode
* JSON Schema oluşturma

### Destek Paketleri

[Destek Paketleri](/tr/api-portal/destek-paketleri) modülü, kullanıcılara sunulacak destek hizmetlerini yönetir.

**Özellikler:**

* Destek paketi oluşturma ve yönetimi
* SLA seviyeleri ve özellikler
* Fiyatlandırma
* Destek talepleri yönetimi
* Jira entegrasyonu

### Organizasyon Görünürlüğü

[Organizasyon Görünürlüğü](/tr/api-portal/organizasyon-gorunurlugu) modülü, organizasyonların API kullanımını izlemenizi sağlar.

**Özellikler:**

* Organizasyon bazlı API erişim raporları
* Hesap ve API ürün ilişkileri
* Durum takibi ve analiz

## Portal İş Akışı

### Geliştirici Perspektifi

1. **Kayıt**: Portal'a kayıt olur ve e-posta onaylar
2. **Onay**: Hesap onaylanır (otomatik veya manuel)
3. **Keşfetme**: API kataloğunu inceler ve ilgilendiği API'leri bulur
4. **Uygulama Oluşturma**: API'lere erişmek için bir uygulama oluşturur
5. **Abonelik**: İstediği API Product'a bir plan seçerek abone olur
6. **API Key Alma**: Abonelik onaylandıktan sonra API Key'lerini alır
7. **Test ve Kullanım**: Try It konsolu ile test eder ve uygulamasında kullanır
8. **İzleme**: Analytics ile kullanımını izler

### Yönetici Perspektifi

1. **Portal Kurulumu**: Portal ayarlarını yapılandırır
2. **API Ürün Oluşturma**: API'leri ürün olarak paketler ve yayınlar
3. **Görünürlük Ayarlama**: Public, Private veya Authorized Organizations seçer
4. **Plan Tanımlama**: Fiyatlandırma planları oluşturur
5. **Onay Yönetimi**: Geliştirici kayıtlarını ve abonelikleri onaylar
6. **İzleme**: Kullanım istatistiklerini ve raporları inceler
7. **Destek**: Destek taleplerini yönetir

## Portal ve Manager İlişkisi

API Developer Portal, Apinizer API Manager ile yakından entegre çalışır:

* **API Manager**: API Proxy'lerin oluşturulduğu, yapılandırıldığı ve deploy edildiği yerdir
* **API Portal**: API Manager'da yayınlanan API'lerin geliştiricilere sunulduğu yerdir
* **Tek Yönlü Veri Akışı**: Portal, Manager'dan API bilgilerini okur; Manager'da yapılan değişiklikler otomatik olarak Portal'a yansır
* **Yayınlama**: API Product'lar Manager'da yayınlandığında Portal'da görünür hale gelir

## Önemli Notlar

<Info>
  * Portal'ın çalışması için API Manager'da API Proxy'lerin oluşturulmuş ve deploy edilmiş olması gerekir
  * Portal ayarlarından Elasticsearch entegrasyonu yapılmışsa analytics özellikleri kullanılabilir
  * Self-service kayıt özelliği portal ayarlarından aktifleştirilmelidir
  * Çoklu dil desteği için her iki dil seçeneği de aktif olmalıdır
</Info>

<Warning>
  * Portal'da yapılan değişiklikler (API Product içerikleri, planlar, dokümantasyon) API Manager üzerinden yapılmalıdır
  * Portal kullanıcıları sadece kendi uygulamalarını ve aboneliklerini yönetebilir
  * API Key'ler bir kez gösterilir ve tekrar görüntülenemez; güvenli bir yerde saklanmalıdır
</Warning>
