Skip to content

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

Open
kerem-acer wants to merge 1 commit into
mainfrom
docs/entegrasyon/api-docs-token-access
Open

kerem-acer wants to merge 1 commit into
mainfrom
docs/entegrasyon/api-docs-token-access

Conversation

@kerem-acer

Copy link
Copy Markdown
Contributor

Neden

InsurUp/core#1602 Core API'nin dokümantasyon erişimini değiştiriyor ve bu sitedeki bazı yönlendirmeler o PR deploy edilince yanlış olacak:

  • /openapi/v1.json kaldırıldı. Yerine kitleye göre beş doküman geldi: public herkese açık, customer müşteri token'ı, agent acente token'ı, admin admin panel token'ı ister.
  • api.insurup.com/scalar token'sız açılınca artık yalnız Public dokümanı gösteriyor. Bu sitedeki rehberler oraya "tüm endpoint'ler" diye yönlendiriyordu.
  • /graphql/schema ve GraphQL introspection artık acente token'ı istiyor. İki sayfa şemanın anonim olduğunu söylüyordu.
  • api.insurup.com kök adresi artık bir giriş sayfası. Token kutusu, beş doküman (Scalar / Swagger UI), GraphQL (Nitro) ve SignalR hub'larına giden linkler orada.

Ne değişiyor

Sayfa Değişiklik
musteri-belgesi-pdf v1.json yerine agent.json + Authorization: Bearer notu
mobil-projeler…, tss-aile, web-satis-platformunda-subeli…, self-servis… Scalar yönlendirmeleri → api.insurup.com; müşteri endpoint'leri için Customer dokümanı ve müşteri token'ı
b2b-crm, dis-police Scalar yönlendirmeleri → api.insurup.com; Agent dokümanı ve acente token'ı
graphql-crm-liste SDL acente token'ı ister; curl örneğine Authorization eklendi; Nitro (/graphql/ui/) satırı eklendi
b2b-crm "/graphql/schema public, authentication gerektirmez" → acente token'ı gerekir

Merge zamanı

InsurUp/core#1602 production'a çıktıktan sonra merge edin. Daha önce merge edilirse bu sayfalar henüz var olmayan davranışı anlatır.

Bu PR'da olmayan

mobil-projeler-icin-web-satis-platformu-entegrasyonu sayfası müşteri uygulamalarına SignalR event'lerini (ReceiveProposalProduct*) dinlemelerini söylüyor. Ancak bu event'leri gönderen /hubs/proposal-detail hub'ı yalnız acente token'ı kabul ediyor. Hangisinin doğru olduğu ayrı bir karar; bu PR o bölüme dokunmuyor.

🤖 Generated with Claude Code

Core API'nin OpenAPI açıklaması kitleye göre beş dokümana bölündü
(InsurUp/core#1602): public herkese açık, customer müşteri token'ı, agent
acente token'ı ister. /openapi/v1.json kaldırıldı; /graphql/schema ve
introspection acente token'ı ister.

- "Tüm endpoint'ler için api.insurup.com/scalar" yönlendirmeleri,
  rehberin kitlesine göre token ve doküman adını söyleyecek şekilde
  api.insurup.com giriş sayfasına çevrildi.
- musteri-belgesi-pdf: v1.json yerine agent.json ve token notu.
- GraphQL şemasının anonim olduğu yazan iki yer düzeltildi; curl örneğine
  Authorization eklendi, Nitro (api.insurup.com/graphql/ui) eklendi.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kerem-acer kerem-acer added the documentation Improvements or additions to documentation label Oct 9, 2026
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 9d4d520
Status:🚫  Build failed.

View logs

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant