GraphQL, modern API geli\u015ftirme d\u00fcnyas\u0131nda veri sorgulama ve manip\u00fclasyonu i\u00e7in g\u00fc\u00e7l\u00fc ve esnek bir yakla\u015f\u0131m sunar. REST API’lerinin aksine, GraphQL’de istemciler tam olarak ihtiya\u00e7 duyduklar\u0131 veriyi tek bir istekte talep edebilirler. Bu esnekli\u011fin ve g\u00fcc\u00fcn temelinde, GraphQL’in en kritik bile\u015feni olan Tip Sistemi<\/strong> yatar. Tip sistemi, bir GraphQL API’sinin destekledi\u011fi t\u00fcm verileri ve i\u015flemleri tan\u0131mlayan bir s\u00f6zle\u015fme gibidir. Bu makalede, GraphQL tip sisteminin derinliklerine inecek, temel bile\u015fenlerini, ileri d\u00fczey \u00f6zelliklerini ve geli\u015ftiricilere sundu\u011fu avantajlar\u0131 detayl\u0131 bir \u015fekilde inceleyece\u011fiz.<\/p>\n GraphQL tip sistemi, bir API’nin sunabilece\u011fi verinin \u015feklini, yap\u0131s\u0131n\u0131 ve ili\u015fkilerini tan\u0131mlayan bir dildir. T\u00fcm GraphQL API’leri, belirli bir tip sistemi taraf\u0131ndan tan\u0131mlanan bir \u015fema (schema) \u00fczerinde \u00e7al\u0131\u015f\u0131r. Bu \u015fema, istemci ile sunucu aras\u0131nda bir k\u00f6pr\u00fc g\u00f6revi g\u00f6r\u00fcr ve her iki taraf\u0131n da hangi verilerin mevcut oldu\u011fu, nas\u0131l sorgulanabilece\u011fi veya de\u011fi\u015ftirilebilece\u011fi konusunda net bir anlay\u0131\u015fa sahip olmas\u0131n\u0131 sa\u011flar.<\/p>\n Tip sistemi, a\u015fa\u011f\u0131daki temel i\u015flevleri yerine getirir: T\u00fcm bu yetenekler, GraphQL’in kendi \u015eema Tan\u0131mlama Dili (Schema Definition Language – SDL)<\/strong> kullan\u0131larak tan\u0131mlan\u0131r. SDL, insan taraf\u0131ndan okunabilir ve yaz\u0131labilir, tip sistemini ifade etmek i\u00e7in \u00f6zel bir s\u00f6zdizimine sahiptir.<\/p>\n GraphQL tip sisteminin temelini olu\u015fturan birka\u00e7 ana kavram vard\u0131r:<\/p>\n \u015eema, bir GraphQL API’sinin kalbidir. Bir API’nin t\u00fcm veri tiplerini, sorgular\u0131n\u0131, mutasyonlar\u0131n\u0131 ve aboneliklerini (subscriptions) tan\u0131mlayan bir s\u00f6zle\u015fmedir. \u015eema, \u00fc\u00e7 \u00f6zel “k\u00f6k tip” ile ba\u015flar: Bir GraphQL \u015femas\u0131 genellikle SDL, GraphQL \u015femas\u0131n\u0131 yazmak i\u00e7in kullan\u0131lan dildir. SQL veya JSON gibi di\u011fer veri tan\u0131mlama dillerine benzer ancak GraphQL i\u00e7in \u00f6zel olarak tasarlanm\u0131\u015ft\u0131r. SDL, tipleri, alanlar\u0131, arg\u00fcmanlar\u0131 ve y\u00f6nergeleri (directives) tan\u0131mlamak i\u00e7in basit ve sezgisel bir s\u00f6zdizimi sunar.<\/p>\n \u00d6rnek bir SDL tan\u0131m\u0131:<\/p>\n Bu \u00f6rnek, GraphQL tip sistemi, verileri yap\u0131land\u0131rmak i\u00e7in \u00e7e\u015fitli temel tip t\u00fcrleri sunar:<\/p>\n Skaler tipler, bir GraphQL sorgusunun en k\u00fc\u00e7\u00fck, atomik veri birimleridir. Bunlar, daha fazla par\u00e7aya ayr\u0131lamayan temel de\u011ferlerdir. GraphQL, varsay\u0131lan olarak birka\u00e7 yerle\u015fik skaler tip sa\u011flar: \u00d6zel Skalerler (Custom Scalars):<\/strong> Geli\u015ftiriciler, \u00d6rnek \u00f6zel skaler tan\u0131m\u0131:<\/p>\n Nesne tipleri, bir GraphQL \u015femas\u0131n\u0131n temel yap\u0131 ta\u015flar\u0131d\u0131r. Uygulaman\u0131zdaki bir “\u015fey”i veya bir “varl\u0131\u011f\u0131” temsil ederler ve bir dizi alana (fields) sahiptirler. Her alan\u0131n bir ad\u0131 ve bir tipi vard\u0131r.<\/p>\n \u00d6rnek:<\/p>\n * Enum tipleri, belirli bir alan i\u00e7in izin verilen de\u011ferlerin s\u0131n\u0131rl\u0131 bir k\u00fcmesini tan\u0131mlar. Bu, kodda sabit de\u011ferleri kullanmak yerine daha anlaml\u0131 ve hata olas\u0131l\u0131\u011f\u0131 d\u00fc\u015f\u00fck bir yol sunar.<\/p>\n \u00d6rnek:<\/p>\n Bu \u00f6rnekte, Girdi nesne tipleri, mutasyonlara veya sorgulara karma\u015f\u0131k nesneleri arg\u00fcman olarak iletmek i\u00e7in kullan\u0131l\u0131r. Normal nesne tiplerinden farkl\u0131 olarak, girdi tiplerinin alanlar\u0131 arg\u00fcman alamaz ve sadece skaler, enum veya di\u011fer girdi tipleri olabilir.<\/p>\n \u00d6rnek:<\/p>\n Burada GraphQL tip sistemi, daha karma\u015f\u0131k veri yap\u0131lar\u0131n\u0131 ve ili\u015fkileri modellemek i\u00e7in geli\u015fmi\u015f \u00f6zellikler sunar.<\/p>\n Aray\u00fczler, birden fazla nesne tipinin payla\u015fabilece\u011fi bir dizi alan\u0131 tan\u0131mlar. Bir nesne tipi bir aray\u00fcz\u00fc uygulad\u0131\u011f\u0131nda, o aray\u00fczde tan\u0131mlanan t\u00fcm alanlara sahip olmak zorundad\u0131r. Bu, polimorfik sorgular yazmaya olanak tan\u0131r.<\/p>\n \u00d6rnek:<\/p>\n Bu \u00f6rnekte, Birlikler, bir alan\u0131n farkl\u0131 nesne tiplerinden herhangi birini d\u00f6nd\u00fcrebilece\u011fini belirtir, ancak aray\u00fczlerin aksine, bu tiplerin ortak alanlara sahip olmas\u0131 gerekmez. Birlikler, genellikle bir arama sonucunun farkl\u0131 t\u00fcrde \u00f6\u011feler i\u00e7erebilece\u011fi veya bir hata tipinin farkl\u0131 hata nesneleri olabilece\u011fi senaryolarda kullan\u0131l\u0131r.<\/p>\n \u00d6rnek:<\/p>\n Burada GraphQL tip sistemi, alanlar ve arg\u00fcmanlar arac\u0131l\u0131\u011f\u0131yla karma\u015f\u0131k ili\u015fkileri tan\u0131mlaman\u0131n yan\u0131 s\u0131ra, \u015femaya meta veri eklemek ve \u00e7al\u0131\u015fma zaman\u0131 davran\u0131\u015f\u0131n\u0131 etkilemek i\u00e7in y\u00f6nergeler kullan\u0131r.<\/p>\n Her nesne tipinin, kendi tipine ve iste\u011fe ba\u011fl\u0131 olarak arg\u00fcmanlara sahip alanlar\u0131 vard\u0131r. Arg\u00fcmanlar, istemcilerin bir alan\u0131n d\u00f6nd\u00fcrd\u00fc\u011f\u00fc veriyi filtrelemesine veya \u015fekillendirmesine olanak tan\u0131r.<\/p>\n \u00d6rnek:<\/p>\n Bu \u00f6rnekte, Y\u00f6nlendiriciler, GraphQL \u015femas\u0131na veya sorgular\u0131na meta veri eklemek i\u00e7in kullan\u0131lan \u00f6zel i\u015faretlerdir. \u00d6rnek:<\/p>\n Geli\u015ftiriciler ayr\u0131ca kendi \u00f6zel y\u00f6nergelerini de tan\u0131mlayabilirler. \u00d6zel y\u00f6nergeler, \u015fema d\u00f6n\u00fc\u015f\u00fcmleri, yetkilendirme kontrolleri veya \u00e7al\u0131\u015fma zaman\u0131 davran\u0131\u015flar\u0131n\u0131 de\u011fi\u015ftirmek gibi g\u00fc\u00e7l\u00fc senaryolar i\u00e7in kullan\u0131labilir.<\/p>\n GraphQL tip sistemi, geli\u015ftiricilere ve API t\u00fcketicilerine bir dizi \u00f6nemli avantaj sunar:<\/p>\n Tip sistemi, hem istemci taraf\u0131nda (sorgular olu\u015fturulurken) hem de sunucu taraf\u0131nda (sorgular y\u00fcr\u00fct\u00fcl\u00fcrken) otomatik veri do\u011frulamas\u0131 sa\u011flar. Bu, yanl\u0131\u015f tiplerde veri g\u00f6nderilmesini veya al\u0131nmas\u0131n\u0131 engeller, b\u00f6ylece hata oran\u0131n\u0131 azalt\u0131r ve daha sa\u011flam uygulamalar olu\u015fturulmas\u0131na yard\u0131mc\u0131 olur.<\/p>\n GraphQL’in en g\u00fc\u00e7l\u00fc \u00f6zelliklerinden biri i\u00e7 g\u00f6zlemdir. \u015eema, kendisi hakk\u0131nda bilgi edinmek i\u00e7in sorgulanabilir. Bu, GraphiQL gibi ara\u00e7lar\u0131n otomatik olarak API dok\u00fcmantasyonu olu\u015fturmas\u0131na, sorgu alanlar\u0131n\u0131 otomatik tamamlamas\u0131na ve potansiyel hatalar\u0131 vurgulamas\u0131na olanak tan\u0131r. Geli\u015ftiricilerin API’yi \u00f6\u011frenme ve kullanma s\u00fcresini \u00f6nemli \u00f6l\u00e7\u00fcde k\u0131salt\u0131r.<\/p>\n Tutarl\u0131 ve iyi tan\u0131mlanm\u0131\u015f bir tip sistemi, geli\u015ftiricilerin API ile etkile\u015fimini basitle\u015ftirir. \u0130stemci taraf\u0131nda, tip bilgisi sayesinde kod \u00fcretimi (code generation) yap\u0131labilir, bu da sorgular\u0131n ve mutasyonlar\u0131n g\u00fcvenli bir \u015fekilde olu\u015fturulmas\u0131n\u0131 sa\u011flar. Sunucu taraf\u0131nda, tip sistemi, resolver’lar\u0131n do\u011fru veri tiplerini d\u00f6nd\u00fcrmesini garanti eder.<\/p>\n GraphQL, REST’in aksine, API versiyonlama ihtiyac\u0131n\u0131 \u00f6nemli \u00f6l\u00e7\u00fcde azalt\u0131r. Tip sistemi, istemcilerin yaln\u0131zca \u015femada tan\u0131mlanan verilere eri\u015febilmesini sa\u011flar. Bu, k\u00f6t\u00fc niyetli veya yanl\u0131\u015f bi\u00e7imlendirilmi\u015f sorgular\u0131n sunucuya ula\u015fmas\u0131n\u0131 ve beklenmeyen davran\u0131\u015flara yol a\u00e7mas\u0131n\u0131 engeller. Ayr\u0131ca, tip sistemi, yetkilendirme mant\u0131\u011f\u0131n\u0131n belirli alanlara veya tiplere uygulanmas\u0131n\u0131 kolayla\u015ft\u0131r\u0131r.<\/p>\n Etkili bir GraphQL API’si olu\u015fturmak i\u00e7in tip sistemini do\u011fru bir \u015fekilde tasarlamak kritik \u00f6neme sahiptir. \u0130\u015fte baz\u0131 en iyi uygulamalar:<\/p>\n Tipler, alanlar ve arg\u00fcmanlar i\u00e7in a\u00e7\u0131k, a\u00e7\u0131klay\u0131c\u0131 ve tutarl\u0131 adlar kullan\u0131n. Bu, \u015feman\u0131n okunabilirli\u011fini ve anla\u015f\u0131l\u0131rl\u0131\u011f\u0131n\u0131 art\u0131r\u0131r. PascalCase tipler i\u00e7in, camelCase alanlar ve arg\u00fcmanlar i\u00e7in yayg\u0131n olarak kabul g\u00f6rm\u00fc\u015f adland\u0131rma kurallar\u0131d\u0131r.<\/p>\n B\u00fcy\u00fck, monolitik tipler yerine daha k\u00fc\u00e7\u00fck, odaklanm\u0131\u015f tipler olu\u015fturun. Bu, \u015feman\u0131n daha mod\u00fcler olmas\u0131n\u0131 sa\u011flar ve gelecekteki de\u011fi\u015fiklikleri kolayla\u015ft\u0131r\u0131r. \u00d6rne\u011fin, bir \u015eeman\u0131z\u0131 gelecekteki b\u00fcy\u00fcme ve de\u011fi\u015fiklikleri g\u00f6z \u00f6n\u00fcnde bulundurarak tasarlay\u0131n. Yeni alanlar eklemeyi veya mevcut alanlar\u0131 kullan\u0131mdan kald\u0131rmay\u0131 kolayla\u015ft\u0131racak bir yap\u0131 kurun. Aray\u00fczler ve birlikler, gelecekte yeni tipler eklemeyi kolayla\u015ft\u0131ran g\u00fc\u00e7l\u00fc geni\u015fletilebilirlik mekanizmalar\u0131d\u0131r.<\/p>\n GraphQL’de hata y\u00f6netimi, genellikle sorgu sonucunun GraphQL’in GraphQL tip sistemi, modern API geli\u015ftirmenin temel ta\u015f\u0131d\u0131r. Veri tan\u0131mlama, do\u011frulama, i\u00e7 g\u00f6zlem ve API evrimi gibi kritik i\u015flevleri yerine getirerek, hem sunucu hem de istemci taraf\u0131nda geli\u015ftiriciler i\u00e7in e\u015fsiz bir deneyim sunar. Skalerlerden nesne tiplerine, aray\u00fczlerden birliklere kadar \u00e7e\u015fitli tip t\u00fcrleri sayesinde, karma\u015f\u0131k veri modelleri basit ve sezgisel bir \u015fekilde ifade edilebilir.<\/p>\n \u0130yi tasarlanm\u0131\u015f bir GraphQL \u015femas\u0131, g\u00fc\u00e7l\u00fc, esnek ve s\u00fcrd\u00fcr\u00fclebilir bir API’nin temelini olu\u015fturur. Geli\u015ftiricilerin tip sisteminin g\u00fcc\u00fcn\u00fc anlamas\u0131 ve en iyi uygulamalar\u0131 benimsemesi, GraphQL’in potansiyelinden tam olarak yararlanmalar\u0131n\u0131 sa\u011flayacakt\u0131r. GraphQL’in tip sistemi, sadece bir veri tan\u0131mlama arac\u0131 olman\u0131n \u00f6tesinde, istemci ile sunucu aras\u0131nda g\u00fcvenilir bir s\u00f6zle\u015fme ve i\u015fbirli\u011fi platformu olarak hizmet vermektedir. Bu sayede, uygulamalar daha h\u0131zl\u0131 geli\u015ftirilebilir, daha az hata i\u00e7erir ve zamanla daha kolay evrimle\u015febilir.<\/body><\/p>\n","protected":false},"excerpt":{"rendered":"GraphQL Tip Sistemini Anlamak GraphQL, modern API geli\u015ftirme d\u00fcnyas\u0131nda veri sorgulama ve manip\u00fclasyonu i\u00e7in g\u00fc\u00e7l\u00fc ve esnek bir yakla\u015f\u0131m sunar.","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"csco_page_header_type":"","csco_page_load_nextpost":"","csco_page_subscribe_form":"","csco_page_contact_form":"","footnotes":""},"categories":[1],"tags":[],"class_list":{"0":"post-40958","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-genel","7":"cs-entry","8":"cs-video-wrap"},"yoast_head":"\nGraphQL Tip Sistemi Nedir?<\/h3>\n
\n* Veri Do\u011frulama:<\/strong> \u0130stemciden gelen sorgular\u0131n ve mutasyonlar\u0131n \u015femaya uygun olup olmad\u0131\u011f\u0131n\u0131 kontrol eder.
\n* \u0130\u00e7 G\u00f6zlem (Introspection):<\/strong> \u0130stemcilerin, mevcut tipleri ve alanlar\u0131 dinamik olarak ke\u015ffetmesini sa\u011flar. Bu, GraphiQL veya Apollo Studio gibi ara\u00e7lar\u0131n otomatik tamamlama ve dok\u00fcmantasyon sa\u011flamas\u0131na olanak tan\u0131r.
\n* Geli\u015ftirici Deneyimi:<\/strong> Tutarl\u0131 bir yap\u0131 sunarak geli\u015ftiricilerin API’yi daha kolay anlamas\u0131na ve kullanmas\u0131na yard\u0131mc\u0131 olur.
\n* API Evrimi:<\/strong> \u015eeman\u0131n kontroll\u00fc bir \u015fekilde geli\u015ftirilmesine ve de\u011fi\u015fmesine olanak tan\u0131r, b\u00f6ylece istemciler \u00fczerinde y\u0131k\u0131c\u0131 etki yaratmadan yeni \u00f6zellikler eklenebilir veya eski alanlar kullan\u0131mdan kald\u0131r\u0131labilir.<\/p>\nTemel Kavramlar<\/h3>\n
\u015eema (Schema)<\/h4>\n
\n* Query (Sorgu):<\/strong> Veri okuma i\u015flemlerini tan\u0131mlar. Bir istemci veri almak istedi\u011finde, Query tipinin alanlar\u0131n\u0131 kullan\u0131r.
\n* Mutation (Mutasyon):<\/strong> Veri yazma, de\u011fi\u015ftirme veya silme i\u015flemlerini tan\u0131mlar. Veritaban\u0131nda bir de\u011fi\u015fiklik yapmak istendi\u011finde bu tip kullan\u0131l\u0131r.
\n* Subscription (Abonelik):<\/strong> Ger\u00e7ek zamanl\u0131 veri ak\u0131\u015flar\u0131n\u0131 tan\u0131mlar. Bir olay meydana geldi\u011finde istemcilere otomatik olarak veri g\u00f6nderir.<\/p>\nschema { query: Query, mutation: Mutation, subscription: Subscription }<\/code> \u015feklinde tan\u0131mlan\u0131r ve bu k\u00f6k tiplerin her biri, API’nin sunaca\u011f\u0131 \u00f6zel i\u015flemleri temsil eden alanlara sahiptir.<\/p>\n\u015eema Tan\u0131mlama Dili (Schema Definition Language – SDL)<\/h4>\n
type User {\n id: ID!\n name: String!\n email: String\n posts: [Post!]!\n}\n\ntype Post {\n id: ID!\n title: String!\n content: String\n author: User!\n}\n\ntype Query {\n user(id: ID!): User\n users: [User!]!\n post(id: ID!): Post\n posts: [Post!]!\n}\n\ntype Mutation {\n createUser(name: String!, email: String): User!\n createPost(title: String!, content: String, authorId: ID!): Post!\n}<\/code><\/pre>\nUser<\/code> ve Post<\/code> ad\u0131nda iki nesne tipi, bunlar\u0131n alanlar\u0131 ve bu tipleri d\u00f6nd\u00fcren veya arg\u00fcman olarak alan Query<\/code> ve Mutation<\/code> tiplerini g\u00f6stermektedir.<\/p>\nTemel Tip T\u00fcrleri<\/h3>\n
Skaler Tipler (Scalar Types)<\/h4>\n
\n* String<\/code>:<\/strong> UTF-8 karakter dizisi.
\n* Int<\/code>:<\/strong> \u0130\u015faretli 32-bit tam say\u0131.
\n* Float<\/code>:<\/strong> \u00c7ift duyarl\u0131kl\u0131 kayan nokta say\u0131s\u0131.
\n* Boolean<\/code>:<\/strong> true<\/code> veya false<\/code>.
\n* ID<\/code>:<\/strong> Benzersiz bir tan\u0131mlay\u0131c\u0131 (genellikle bir String<\/code> olarak serile\u015ftirilir, ancak semantik olarak bir kimlik belirtir).<\/p>\nDate<\/code>, URL<\/code>, JSON<\/code> veya EmailAddress<\/code> gibi kendi \u00f6zel skaler tiplerini de tan\u0131mlayabilirler. Bu, veri tipini daha spesifik hale getirmeye ve istemci ile sunucu aras\u0131nda daha g\u00fc\u00e7l\u00fc bir s\u00f6zle\u015fme olu\u015fturmaya yard\u0131mc\u0131 olur. \u00d6zel skalerler, sunucu taraf\u0131nda nas\u0131l serile\u015ftirilecekleri, seri durumdan \u00e7\u0131kar\u0131lacaklar\u0131 ve do\u011frulanacaklar\u0131 konusunda \u00f6zel mant\u0131k gerektirir.<\/p>\nscalar Date\nscalar URL<\/code><\/pre>\nNesne Tipleri (Object Types)<\/h4>\n
type User {\n id: ID!\n name: String!\n email: String\n posts: [Post!]! # Bir kullan\u0131c\u0131n\u0131n birden fazla g\u00f6nderisi olabilir\n}<\/code><\/pre>\nUser<\/code>: Bir nesne tipinin ad\u0131d\u0131r.
\n* id<\/code>, name<\/code>, email<\/code>, posts<\/code>: Bu tipin alanlar\u0131d\u0131r.
\n* ID!<\/code>, String!<\/code>, String<\/code>, [Post!]!<\/code>: Bu alanlar\u0131n tipleridir. !<\/code> i\u015fareti, alan\u0131n her zaman bir de\u011fer d\u00f6nd\u00fcrmesi gerekti\u011fini (non-nullable) belirtir. []<\/code> k\u00f6\u015feli parantezler, alan\u0131n bir liste (array) oldu\u011funu g\u00f6sterir. [Post!]!<\/code> ise, bu alan\u0131n Post<\/code> nesnelerinin bir listesi oldu\u011funu ve listenin kendisinin null olamayaca\u011f\u0131n\u0131, ayr\u0131ca listedeki her bir Post<\/code> \u00f6\u011fesinin de null olamayaca\u011f\u0131n\u0131 ifade eder.<\/p>\nEnum Tipleri (Enum Types)<\/h4>\n
enum UserRole {\n ADMIN\n EDITOR\n VIEWER\n}\n\ntype User {\n id: ID!\n name: String!\n role: UserRole! # Kullan\u0131c\u0131n\u0131n rol\u00fc bu enum de\u011ferlerinden biri olmal\u0131d\u0131r\n}<\/code><\/pre>\nUserRole<\/code> enum tipi, bir kullan\u0131c\u0131n\u0131n rol\u00fcn\u00fcn yaln\u0131zca ADMIN<\/code>, EDITOR<\/code> veya VIEWER<\/code> olabilece\u011fini belirtir.<\/p>\nGirdi Nesne Tipleri (Input Object Types)<\/h4>\n
input CreateUserInput {\n name: String!\n email: String\n role: UserRole = VIEWER # Varsay\u0131lan de\u011fer atanabilir\n}\n\ntype Mutation {\n createUser(input: CreateUserInput!): User!\n}<\/code><\/pre>\nCreateUserInput<\/code> bir girdi nesne tipidir ve createUser<\/code> mutasyonuna tek bir arg\u00fcman olarak iletilir. Bu, birden fazla arg\u00fcman\u0131 tek bir yap\u0131 alt\u0131nda gruplayarak mutasyon imzalar\u0131n\u0131 daha d\u00fczenli hale getirir.<\/p>\n\u0130leri Tip T\u00fcrleri ve \u0130li\u015fkiler<\/h3>\n
Aray\u00fczler (Interfaces)<\/h4>\n
interface Node {\n id: ID!\n}\n\ntype User implements Node {\n id: ID!\n name: String!\n email: String\n}\n\ntype Product implements Node {\n id: ID!\n name: String!\n price: Float!\n}\n\ntype Query {\n node(id: ID!): Node\n}<\/code><\/pre>\nUser<\/code> ve Product<\/code> tipleri Node<\/code> aray\u00fcz\u00fcn\u00fc uygular ve her ikisi de id<\/code> alan\u0131na sahiptir. node<\/code> sorgusu, Node<\/code> tipinde bir de\u011fer d\u00f6nd\u00fcrebilir; bu, asl\u0131nda bir User<\/code> veya Product<\/code> olabilir. \u0130stemciler, bu t\u00fcr polimorfik tipleri sorgularken “inline fragments” (... on<\/code>) kullanarak belirli tiplere \u00f6zg\u00fc alanlar\u0131 talep edebilirler:<\/p>\nquery GetNode($id: ID!) {\n node(id: $id) {\n id\n ... on User {\n name\n email\n }\n ... on Product {\n price\n }\n }\n}<\/code><\/pre>\nBirlikler\/Birle\u015fimler (Unions)<\/h4>\n
type Book {\n title: String!\n author: String!\n}\n\ntype Movie {\n title: String!\n director: String!\n}\n\nunion SearchResult = Book | Movie\n\ntype Query {\n search(text: String!): [SearchResult!]!\n}<\/code><\/pre>\nSearchResult<\/code> bir birle\u015fim tipidir ve ya bir Book<\/code> ya da bir Movie<\/code> d\u00f6nd\u00fcrebilir. Sorgular yine “inline fragments” kullan\u0131r:<\/p>\nquery SearchItems($text: String!) {\n search(text: $text) {\n ... on Book {\n title\n author\n }\n ... on Movie {\n title\n director\n }\n }\n}<\/code><\/pre>\n\u015eema \u0130li\u015fkileri ve Y\u00f6nlendiriciler (Directives)<\/h3>\n
Alanlar ve Arg\u00fcmanlar (Fields and Arguments)<\/h4>\n
type User {\n id: ID!\n name: String!\n posts(limit: Int, offset: Int): [Post!]! # posts alan\u0131 limit ve offset arg\u00fcmanlar\u0131n\u0131 al\u0131yor\n}<\/code><\/pre>\nposts<\/code> alan\u0131, bir kullan\u0131c\u0131n\u0131n t\u00fcm g\u00f6nderilerini d\u00f6nd\u00fcrmek yerine, limit<\/code> ve offset<\/code> arg\u00fcmanlar\u0131 arac\u0131l\u0131\u011f\u0131yla sayfaland\u0131r\u0131lm\u0131\u015f bir alt k\u00fcmesini d\u00f6nd\u00fcrebilir. Arg\u00fcmanlar varsay\u0131lan de\u011ferlere de sahip olabilir: posts(limit: Int = 10): [Post!]!<\/code>.<\/p>\nY\u00f6nlendiriciler (Directives)<\/h4>\n
@<\/code> sembol\u00fc ile ba\u015flarlar. GraphQL, birka\u00e7 yerle\u015fik y\u00f6nergeye sahiptir:
\n* @include(if: Boolean)<\/code>:<\/strong> Belirli bir alan\u0131n veya par\u00e7an\u0131n yaln\u0131zca if<\/code> arg\u00fcman\u0131 true<\/code> ise sorguya dahil edilmesini sa\u011flar.
\n* @skip(if: Boolean)<\/code>:<\/strong> Belirli bir alan\u0131n veya par\u00e7an\u0131n if<\/code> arg\u00fcman\u0131 true<\/code> ise sorgudan atlanmas\u0131n\u0131 sa\u011flar.
\n* @deprecated(reason: String)<\/code>:<\/strong> Bir alan\u0131n veya enum de\u011ferinin kullan\u0131mdan kald\u0131r\u0131ld\u0131\u011f\u0131n\u0131 belirtir ve genellikle bir gerek\u00e7e sa\u011flar. Bu, API evrimi i\u00e7in \u00e7ok \u00f6nemlidir.<\/p>\ntype Post {\n id: ID!\n title: String!\n content: String @deprecated(reason: \"Use the 'body' field instead.\")\n body: String\n}<\/code><\/pre>\nTip Sisteminin Avantajlar\u0131<\/h3>\n
Veri Do\u011frulama (Data Validation)<\/h4>\n
\u0130\u00e7 G\u00f6zlem (Introspection)<\/h4>\n
Geli\u015ftirici Deneyimi (Developer Experience)<\/h4>\n
API Evrimi (API Evolution)<\/h4>\n
@deprecated<\/code> y\u00f6nergesi gibi \u00f6zellikler, eski alanlar\u0131 kullan\u0131mdan kald\u0131r\u0131rken yeni alanlar eklemeye olanak tan\u0131r. \u0130stemciler, ihtiya\u00e7 duyduklar\u0131 eski alanlar\u0131 kullanmaya devam edebilirken, yeni istemciler g\u00fcncellenmi\u015f \u015femadan yararlanabilir. Bu, API’nin s\u00fcrekli olarak geli\u015fmesini ve geni\u015flemesini sa\u011flar.<\/p>\nG\u00fcvenlik (Security)<\/h4>\n
Tip Sistemini Tasarlarken En \u0130yi Uygulamalar<\/h3>\n
Anlaml\u0131 Adland\u0131rma (Meaningful Naming)<\/h4>\n
Gran\u00fcler Tipler (Granular Types)<\/h4>\n
User<\/code> tipinin t\u00fcm olas\u0131 alanlar\u0131 i\u00e7ermesi yerine, UserProfile<\/code> veya UserAddress<\/code> gibi ayr\u0131 tipler olu\u015fturarak daha iyi bir yap\u0131 elde edilebilir.<\/p>\nGerekli Alanlar (Required Fields)<\/h4>\n
!<\/code> (non-nullable) i\u015faretini dikkatli kullan\u0131n. Bir alan\u0131n her zaman bir de\u011fere sahip olaca\u011f\u0131n\u0131 garanti ediyorsan\u0131z !<\/code> kullan\u0131n. Ancak, bir alan\u0131n null<\/code> olabilece\u011fi durumlar varsa, bunu belirtmek daha esnek bir API sa\u011flar. A\u015f\u0131r\u0131 !<\/code> kullan\u0131m\u0131, istemci taraf\u0131nda gereksiz hata y\u00f6netimine yol a\u00e7abilir.<\/p>\nGeni\u015fletilebilirlik (Extensibility)<\/h4>\n
Hata Y\u00f6netimi (Error Handling)<\/h4>\n
errors<\/code> dizisinde d\u00f6nd\u00fcr\u00fcl\u00fcr. Ancak, daha spesifik hata durumlar\u0131n\u0131 modellemek i\u00e7in \u00f6zel hata tipleri veya birle\u015fim tipleri kullanmak, istemcilerin hatalar\u0131 daha iyi anlamas\u0131na ve i\u015flemesine yard\u0131mc\u0131 olabilir. \u00d6rne\u011fin, bir mutasyonun ba\u015far\u0131l\u0131 bir sonu\u00e7 veya belirli bir hata tipi d\u00f6nd\u00fcrebilece\u011fi bir birle\u015fim tan\u0131mlanabilir.<\/p>\nVersiyonlama Yerine Evrim (Evolution over Versioning)<\/h4>\n
@deprecated<\/code> y\u00f6nergesini kullanarak API’nizi versiyonlamak yerine evrimle\u015ftirin. Bu, istemcilerin eski API’yi kullanmaya devam etmelerini sa\u011flarken, yeni \u00f6zelliklerin sorunsuz bir \u015fekilde tan\u0131t\u0131lmas\u0131na olanak tan\u0131r.<\/p>\nSonu\u00e7<\/h3>\n