diff --git a/docs/entegrasyon/b2b-crm-entegrasyonu.md b/docs/entegrasyon/b2b-crm-entegrasyonu.md index 9ca01d2..2182e81 100644 --- a/docs/entegrasyon/b2b-crm-entegrasyonu.md +++ b/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. diff --git a/docs/entegrasyon/dis-police-entegrasyonu.md b/docs/entegrasyon/dis-police-entegrasyonu.md index 1171280..e43ebe2 100644 --- a/docs/entegrasyon/dis-police-entegrasyonu.md +++ b/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? diff --git a/docs/entegrasyon/graphql-crm-liste-entegrasyonu.md b/docs/entegrasyon/graphql-crm-liste-entegrasyonu.md index 24d1618..f9a629f 100644 --- a/docs/entegrasyon/graphql-crm-liste-entegrasyonu.md +++ b/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 ``` --- diff --git a/docs/entegrasyon/insurup-web-satis-platformu-self-servis-entegrasyon-rehberi.md b/docs/entegrasyon/insurup-web-satis-platformu-self-servis-entegrasyon-rehberi.md index 31998b6..64cb767 100644 --- a/docs/entegrasyon/insurup-web-satis-platformu-self-servis-entegrasyon-rehberi.md +++ b/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. diff --git a/docs/entegrasyon/mobil-projeler-icin-web-satis-platformu-entegrasyonu.md b/docs/entegrasyon/mobil-projeler-icin-web-satis-platformu-entegrasyonu.md index add61dc..404246c 100644 --- a/docs/entegrasyon/mobil-projeler-icin-web-satis-platformu-entegrasyonu.md +++ b/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. diff --git a/docs/entegrasyon/musteri-belgesi-pdf.md b/docs/entegrasyon/musteri-belgesi-pdf.md index e4248da..0bf6557 100644 --- a/docs/entegrasyon/musteri-belgesi-pdf.md +++ b/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. --- diff --git a/docs/entegrasyon/tss-aile-entegrasyonu.md b/docs/entegrasyon/tss-aile-entegrasyonu.md index 9f35fec..80f3f71 100644 --- a/docs/entegrasyon/tss-aile-entegrasyonu.md +++ b/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. diff --git a/docs/entegrasyon/web-satis-platformunda-subeli-yapi-kullanimlari.md b/docs/entegrasyon/web-satis-platformunda-subeli-yapi-kullanimlari.md index 6bfab47..60f6502 100644 --- a/docs/entegrasyon/web-satis-platformunda-subeli-yapi-kullanimlari.md +++ b/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.