Kotlin Multiplatform Academy · Ders

Küçük Bir Genel API Tasarlama

Neleri dışa açacağınıza, neleri dahili tutacağınıza karar verin.

Küçük Bir Genel API Tasarlama, CoddyKit'te ücretsiz bir Kotlin Multiplatform Academy dersidir. Bu, 4 dersinin 1. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, Kotlin Multiplatform Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. Kotlin Multiplatform Academy kursu toplamda 4 dersten oluşur.

Bu dersin bazı bölümleri henüz çevrilmemiş olup İngilizce olarak gösterilmektedir.

What a Public API Is

Your module's public API is the set of functions and types other code is allowed to call. It is the front door both apps walk through.

Small Surface Wins

A small surface area means fewer things to learn and fewer things to break. Expose only what callers truly need, nothing more. 🎯

Start From the Use Case

Design backwards: write the call site you wish you had first. Let that ideal usage shape what your public functions look like.

// Imagine this is how both apps will call you
val text = greeter.greet("Maya")

Expose Intent, Hide Steps

A good API shows the intent and hides the steps. Callers say what they want, not how the work gets done inside.

Name Things Clearly

Clear names are half your API. A method called priceWithTax tells the whole story without any extra docs to read.

fun priceWithTax(base: Double, rate: Double): Double {
    return base + base * rate
}

Prefer Simple Inputs

Take plain, obvious inputs like strings and numbers. Simple parameters make your API easy to call from both Android and iOS.

Return Useful Types

Return shared data classes instead of loose values. A typed result is self-describing and far harder to misuse.

data class Quote(val total: Double, val currency: String)

Hide the Helpers

Internal helpers and rough edges should stay private. Only the entry points a caller actually uses belong in the public API.

Easy to Add, Hard to Remove

Every public thing is a promise. It is easy to add new API later, but removing it can break callers, so expose less up front.

Stay Platform-Neutral

Keep the API platform-neutral. If a signature mentions Android or iOS types, it cannot serve both apps from shared code.

Design for the Reader

The best APIs read like a sentence at the call site. Optimize for the caller, not for whoever wrote the implementation.

Quick Check

Let's test your API design instincts.

Recap

A great public API is small, clearly named, and shaped by real use cases. Expose intent, hide steps, and both teams will love it. 🎉

Sıkça Sorulan Sorular

“Küçük Bir Genel API Tasarlama” dersi ücretsiz mi?

Evet — “Küçük Bir Genel API Tasarlama” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve Kotlin Multiplatform Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. Kotlin Multiplatform Academy kursu toplamda 4 dersten oluşur.

“Küçük Bir Genel API Tasarlama” dersinde ne öğreneceğim?

Neleri dışa açacağınıza, neleri dahili tutacağınıza karar verin. Kotlin Multiplatform Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

Kotlin Multiplatform Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te Kotlin Multiplatform Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 1. dersidir.

“Küçük Bir Genel API Tasarlama” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu Kotlin Multiplatform Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her Kotlin Multiplatform Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

← Kotlin Multiplatform Academy Sayfasına Dön