docs(entegrasyon): API dokümanları ve GraphQL şeması artık token istiyor

docs/entegrasyon/b2b-crm-entegrasyonu.md

@@ -10,7 +10,7 @@ Bu döküman, InsurUp API'lerini kendi CRM veya B2B sistemlerine entegre etmek i
 
 Temel API akışları için [InsurUp Web Satış Platformu Self-servis Entegrasyon Rehberi](/entegrasyon/insurup-web-satis-platformu-self-servis-entegrasyon-rehberi) ve ürün bazlı detaylar için [Kasko Entegrasyon Rehberi](/entegrasyon/insurup-web-satis-platformu-self-servis-kasko-entegrasyon-rehberi) dökümanlarını incelemeniz önerilir. Bu döküman, söz konusu dökümanlardan farklılaşan B2B-spesifik konuları kapsar.
 
-**API Referansı:** Tüm endpoint'lerin detaylı teknik dokümantasyonu için [api.insurup.com/scalar](https://api.insurup.com/scalar) adresini ziyaret edin.
+**API Referansı:** Endpoint'lerin teknik dokümantasyonu [api.insurup.com](https://api.insurup.com) adresindedir. Bu rehberdeki endpoint'ler acente token'ı ister: sayfadaki kutuya acente token'ınızı girip **Agent** dokümanını Scalar veya Swagger UI ile açın.
 
 ## 1. Web Satış Platformu ile B2B entegrasyon farkları
 
@@ -179,7 +179,7 @@ Partner sistemler, müşteri, teklif ve poliçe verilerini GraphQL API üzerinde
 
 **GraphQL Endpoint:** `POST /graphql`
 
-**GraphQL Schema:** `GET /graphql/schema` (public, authentication gerektirmez)
+**GraphQL Schema:** `GET /graphql/schema` (acente token'ı gerekir: `Authorization: Bearer {access_token}`)
 
 ### 5.1 Müşteri sorgulama
 
@@ -362,4 +362,4 @@ API hata yanıtları standart HTTP durum kodları ile döner. `detail` ve `sugge
 
 ---
 
-Bu döküman B2B entegrasyonunun temel farklılıklarını kapsar. Ortak API akışları için ilgili entegrasyon rehberlerine başvurun. API endpoint detayları için [api.insurup.com/scalar](https://api.insurup.com/scalar) adresini kullanın. Entegrasyon sırasında oluşacak sorular için InsurUp teknik ekibiyle iletişime geçebilirsiniz.
+Bu döküman B2B entegrasyonunun temel farklılıklarını kapsar. Ortak API akışları için ilgili entegrasyon rehberlerine başvurun. API endpoint detayları için [api.insurup.com](https://api.insurup.com) adresindeki **Agent** dokümanını kullanın. Entegrasyon sırasında oluşacak sorular için InsurUp teknik ekibiyle iletişime geçebilirsiniz.

docs/entegrasyon/dis-police-entegrasyonu.md

@@ -7,7 +7,7 @@ slug: /entegrasyon/dis-police-entegrasyonu
 
 Bu döküman, InsurUp platformuna **acenteniz dışında düzenlenmiş poliçelerin** kaydedilmesi için kullanılan Dış Poliçe API'sinin nasıl çağrılacağını açıklar. Hedef kitle, entegrasyon gerçekleştirecek partner yazılım ekipleridir.
 
-**API Referansı:** Tüm endpoint'lerin detaylı teknik dokümantasyonu için [api.insurup.com/scalar](https://api.insurup.com/scalar) adresini ziyaret edin.
+**API Referansı:** Endpoint'lerin teknik dokümantasyonu [api.insurup.com](https://api.insurup.com) adresindedir. Bu rehberdeki endpoint'ler acente token'ı ister: sayfadaki kutuya acente token'ınızı (kullanıcı ya da servis hesabı) girip **Agent** dokümanını Scalar veya Swagger UI ile açın.
 
 ## 1. Dış Poliçe Nedir?
 

docs/entegrasyon/graphql-crm-liste-entegrasyonu.md

@@ -30,7 +30,8 @@ InsurUp’da **liste ve arama** işlemleri REST ile değil **GraphQL** üzerinde
 | Kaynak | URL | Açıklama |
 |--------|-----|----------|
 | GraphQL endpoint | `POST https://api.insurup.com/graphql` | Liste, filtre, arama, sayfalama |
-| GraphQL şema (SDL) | `GET https://api.insurup.com/graphql/schema` | Anonim erişilebilir şema dosyası |
+| GraphQL şema (SDL) | `GET https://api.insurup.com/graphql/schema` | Şema dosyası; acente token'ı ister |
+| GraphQL IDE (Nitro) | `https://api.insurup.com/graphql/ui/` | Tarayıcıdan şema keşfi ve sorgu denemesi; acente token'ını bağlantı ayarlarındaki Authorization bölümüne Bearer olarak girin |
 | Tek kayıt detayı | REST | Örn. `GET /customers/{id}`, `GET /proposals/{id}` |
 
 ```http
@@ -176,10 +177,10 @@ Tüm `*New` sorguları **cursor pagination** ve aynı filtre/arama sözlüğün
 - `QueryProposalsResultFilterInput`
 - `QueryPoliciesResultFilterInput`
 
-Şemayı indirmek için:
+Şemayı indirmek için (acente token'ı gerekir; introspection da yalnız acente token'ıyla çalışır):
 
 ```bash
-curl -s https://api.insurup.com/graphql/schema -o insurup-schema.graphql
+curl -s -H "Authorization: Bearer {access_token}" https://api.insurup.com/graphql/schema -o insurup-schema.graphql
 ```
 
 ---

docs/entegrasyon/insurup-web-satis-platformu-self-servis-entegrasyon-rehberi.md

@@ -353,5 +353,5 @@ Aşağıdaki özet, self‑servis entegrasyonun genel akışını gösterir:
 
 ---
 
-Bu rehber, InsurUp Web Satış Platformu’nun API entegrasyonunu uçtan uca açıklar. Entegrasyon sırasında oluşacak sorular için InsurUp teknik ekibiyle iletişime geçebilir ve API değişikliklerini takip etmek için InsurUp’ın resmi dokümantasyon sitesini (api.insurup.com/scalar) kullanabilirsiniz.
+Bu rehber, InsurUp Web Satış Platformu’nun API entegrasyonunu uçtan uca açıklar. Entegrasyon sırasında oluşacak sorular için InsurUp teknik ekibiyle iletişime geçebilir ve API değişikliklerini takip etmek için InsurUp’ın API dokümantasyonunu ([api.insurup.com](https://api.insurup.com); müşteri endpoint'lerinin **Customer** dokümanı müşteri token'ı ister) kullanabilirsiniz.
 

docs/entegrasyon/mobil-projeler-icin-web-satis-platformu-entegrasyonu.md

@@ -10,7 +10,7 @@ Bu rehber, InsurUp Web Satış Platformu'nu mobil uygulamalarına (iOS, Android
 
 Temel API akışları için [InsurUp Web Satış Platformu Self-servis Entegrasyon Rehberi](/entegrasyon/insurup-web-satis-platformu-self-servis-entegrasyon-rehberi) ve ürün bazlı detaylar için [Kasko Entegrasyon Rehberi](/entegrasyon/insurup-web-satis-platformu-self-servis-kasko-entegrasyon-rehberi) dökümanlarını incelemeniz önerilir. Bu rehber, söz konusu dökümanların mobil uygulamalar için tamamlayıcısı niteliğindedir.
 
-**API Referansı:** Tüm endpoint'lerin detaylı teknik dokümantasyonu için [api.insurup.com/scalar](https://api.insurup.com/scalar) adresini ziyaret edin.
+**API Referansı:** Endpoint'lerin teknik dokümantasyonu [api.insurup.com](https://api.insurup.com) adresindedir. Token gerektirmeyen endpoint'ler (ör. `login-or-register`) **Public** dokümanında herkese açıktır; bu rehberdeki müşteri endpoint'leri için sayfadaki kutuya müşteri token'ınızı girip **Customer** dokümanını Scalar veya Swagger UI ile açın.
 
 ## 1. Entegrasyon yaklaşımları
 
@@ -71,7 +71,7 @@ Eğer poliçe bir şube, alt acente veya partner üzerinden üretilecekse, `agen
 | Partner/alt acente adına üretim | Gerekli | Gerekli |
 | UTM takipli partner linkleri | Gerekli | Gerekli |
 
-Bu parametreler; müşteri kaydı (`login-or-register`), müşteri oluşturma ve teklif oluşturma (`proposals`) endpoint'lerinde kullanılır. Detaylar için [api.insurup.com/scalar](https://api.insurup.com/scalar) adresindeki ilgili endpoint açıklamalarına bakın.
+Bu parametreler; müşteri kaydı (`login-or-register`), müşteri oluşturma ve teklif oluşturma (`proposals`) endpoint'lerinde kullanılır. Detaylar için [api.insurup.com](https://api.insurup.com) adresindeki **Public** ve **Customer** dokümanlarında ilgili endpoint açıklamalarına bakın (Customer dokümanı müşteri token'ı ister).
 
 ## 3. Kanal (channel) parametresi
 
@@ -274,4 +274,4 @@ Mobil uygulama için kasko veya trafik entegrasyon akışı:
 
 ---
 
-Bu rehber, mobil uygulama entegrasyonunun temel adımlarını ve mobil ortama özgü gereksinimleri kapsar. API endpoint detayları için [api.insurup.com/scalar](https://api.insurup.com/scalar) adresini kullanın. Entegrasyon sırasında oluşacak sorular için InsurUp teknik ekibiyle iletişime geçebilirsiniz.
+Bu rehber, mobil uygulama entegrasyonunun temel adımlarını ve mobil ortama özgü gereksinimleri kapsar. API endpoint detayları için [api.insurup.com](https://api.insurup.com) adresindeki dokümanları kullanın. Entegrasyon sırasında oluşacak sorular için InsurUp teknik ekibiyle iletişime geçebilirsiniz.

docs/entegrasyon/musteri-belgesi-pdf.md

@@ -428,7 +428,7 @@ Karşılaştırma PDF'i (`POST .../compare-pdf`) detaylı teminat tablosu içeri
 İnsan kullanıcı girişi senaryosunda Authorization Code + PKCE ile alınan kullanıcı token'ı; otomasyon senaryosunda Servis Hesabı (client credentials) token'ı kullanılır. Her iki durumda da `proposal:write` veya `core-api` kapsamı gerekir.
 
 **API şemasını nereden görebilirim?**  
-Güncel OpenAPI belgesi: `https://api.insurup.com/openapi/v1.json`
+Güncel OpenAPI belgesi acente token'ıyla indirilir: `https://api.insurup.com/openapi/agent.json` (`Authorization: Bearer {access_token}`). Tarayıcıdan bakmak için [api.insurup.com](https://api.insurup.com) sayfasındaki kutuya token'ınızı girip **Agent** dokümanını Scalar veya Swagger UI ile açın.
 
 ---
 

docs/entegrasyon/tss-aile-entegrasyonu.md

@@ -10,7 +10,7 @@ Bu rehber, InsurUp Web Satış Platformu üzerinden Tamamlayıcı Sağlık Sigor
 
 Temel TSS akışı için [TSS Entegrasyon Rehberi](/entegrasyon/insurup-web-satis-platformu-self-servis-tss-entegrasyon-rehberi), genel entegrasyon akışı için [Self-servis Entegrasyon Rehberi](/entegrasyon/insurup-web-satis-platformu-self-servis-entegrasyon-rehberi) dökümanlarını incelemeniz önerilir.
 
-**API Referansı:** Tüm endpoint'lerin detaylı teknik dokümantasyonu için [api.insurup.com/scalar](https://api.insurup.com/scalar) adresini ziyaret edin.
+**API Referansı:** Endpoint'lerin teknik dokümantasyonu [api.insurup.com](https://api.insurup.com) adresindedir. Bu rehberdeki müşteri endpoint'leri için sayfadaki kutuya müşteri token'ınızı girip **Customer** dokümanını Scalar veya Swagger UI ile açın.
 
 :::tip Yeni aile modülü
 Eski modelde her aile üyesi için ayrı bir teklif oluşturuluyordu. Yeni aile modülünde **tek bir TSS teklifi** ana sigortalı ile birlikte en fazla 4 ek sigortalıyı (toplam 5 kişi) aynı poliçede kapsar. Yeni akış, `POST /api/proposals` isteğinin `additionalInsuredCustomers` alanı üzerinden yönetilir.
@@ -458,4 +458,4 @@ Hayır. İlişki silme işlemi yalnızca CRM'deki müşteri ilişki kaydını ka
 
 ---
 
-Bu rehber, InsurUp Web Satış Platformu'nda TSS ürünü için yeni aile modülünün uçtan uca entegrasyonunu açıklar. Temel TSS akışı için [TSS Entegrasyon Rehberi](/entegrasyon/insurup-web-satis-platformu-self-servis-tss-entegrasyon-rehberi) dökümanına, API endpoint detayları için [api.insurup.com/scalar](https://api.insurup.com/scalar) adresine bakabilirsiniz. Entegrasyon sırasında oluşacak sorular için InsurUp teknik ekibiyle iletişime geçebilirsiniz.
+Bu rehber, InsurUp Web Satış Platformu'nda TSS ürünü için yeni aile modülünün uçtan uca entegrasyonunu açıklar. Temel TSS akışı için [TSS Entegrasyon Rehberi](/entegrasyon/insurup-web-satis-platformu-self-servis-tss-entegrasyon-rehberi) dökümanına, API endpoint detayları için [api.insurup.com](https://api.insurup.com) adresindeki **Customer** dokümanına bakabilirsiniz. Entegrasyon sırasında oluşacak sorular için InsurUp teknik ekibiyle iletişime geçebilirsiniz.

docs/entegrasyon/web-satis-platformunda-subeli-yapi-kullanimlari.md

@@ -10,7 +10,7 @@ Bu doküman, InsurUp Web Satış Platformu'nu kullanan acentelerin **şube (bran
 
 Temel API akışları için [InsurUp Web Satış Platformu Self-servis Entegrasyon Rehberi](/entegrasyon/insurup-web-satis-platformu-self-servis-entegrasyon-rehberi), ürün bazlı detaylar için [Kasko Entegrasyon Rehberi](/entegrasyon/insurup-web-satis-platformu-self-servis-kasko-entegrasyon-rehberi) ve [TSS Entegrasyon Rehberi](/entegrasyon/insurup-web-satis-platformu-self-servis-tss-entegrasyon-rehberi) dökümanlarını incelemeniz önerilir.
 
-**API Referansı:** Tüm endpoint'lerin detaylı teknik dokümantasyonu için [api.insurup.com/scalar](https://api.insurup.com/scalar) adresini ziyaret edin.
+**API Referansı:** Endpoint'lerin teknik dokümantasyonu [api.insurup.com](https://api.insurup.com) adresindedir. Token gerektirmeyen endpoint'ler (ör. `login-or-register`) **Public** dokümanında herkese açıktır; müşteri endpoint'leri için sayfadaki kutuya müşteri token'ınızı girip **Customer** dokümanını Scalar veya Swagger UI ile açın.
 
 ## 1. Şubeli yapı nedir?
 
@@ -353,4 +353,4 @@ Aşağıdaki akış, şubeli yapıda bir B2C satış sürecinin uçtan uca adım
 
 ---
 
-Bu rehber, InsurUp Web Satış Platformu'nda şubeli yapı kullanımının teknik detaylarını ve en iyi uygulamalarını kapsar. Entegrasyon sırasında oluşacak sorular için InsurUp teknik ekibiyle iletişime geçebilir ve endpoint detayları için [api.insurup.com/scalar](https://api.insurup.com/scalar) adresini kullanabilirsiniz.
+Bu rehber, InsurUp Web Satış Platformu'nda şubeli yapı kullanımının teknik detaylarını ve en iyi uygulamalarını kapsar. Entegrasyon sırasında oluşacak sorular için InsurUp teknik ekibiyle iletişime geçebilir ve endpoint detayları için [api.insurup.com](https://api.insurup.com) adresindeki dokümanları kullanabilirsiniz.