API gelistirme

API: sirketinizin servisinin baska sistemlerle konusmasi

API gelistirme — REST, GraphQL veya tRPC tabanli, dokumante edilmis, versiyonlanmis ve test edilmis API. Public API, internal API veya partner API.

OpenAPI / GraphQL schema spec, automatic SDK generation, rate limiting, authentication, monitoring — uctan uca profesyonel API teslim.

API projesi baslat Tum hizmetler

API gelistirme tesliminde standart

REST + OpenAPI 3 spec
GraphQL + schema-first design
tRPC (TypeScript end-to-end)
Auth: OAuth, API key, JWT
Rate limit + caching + monitoring

01.

REST, GraphQL, tRPC — hangisi?

REST en yaygin, en olgun, en cok dokumante edilen tip. Public API icin standart secim. OpenAPI 3 spec ile dokumante edilir; SDK generation otomatik.

GraphQL: client'in tam olarak hangi alani istediginin onayina dayali; over-fetching ve under-fetching problemini cozer. Cogu mobil app + web frontend ortak data ihtiyacinda dogru secim.

tRPC: full-stack TypeScript projelerinde en hizli yol. End-to-end tip guvenligi; SDK generation gerekli degil cunku TypeScript kendisi.

02.

API tasarim prensipleri

Resource-based URL'ler (REST) veya schema-first design (GraphQL), tutarlı naming convention, pagination, filtering, sorting standardizasyonu, error format tutarliligi (RFC 7807 problem details), versioning stratejisi (URL path veya header).

Bu prensipler 'detail' degil, API'nin 5-10 yillik kullanimini belirler. Yanlis tasarlanmis API ileride breaking change ile duzeltilmek zorunda kalir; bu kullanicilarinizi rahatsiz eder.

03.

Auth ve guvenlik

API auth secenekleri: OAuth 2.0 (third-party erisimi), API key (server-to-server), JWT (kullanici-baz�nda short-lived), session-based (browser-baz�nda). Karari kullanim case'ine gore aliyoruz.

Rate limiting (per-user, per-IP, per-endpoint), CORS dogru konfigurasyon, input validation (Zod), SQL injection prevention, secrets rotation — guvenligin temel parcasi.

04.

Dokumentasyon ve developer experience

API'nin basarisi developer experience'e bagli. OpenAPI 3 (REST) veya GraphQL schema (GraphQL) ile auto-generated dokumantasyon. Swagger UI / GraphQL Playground / tRPC docs ile interactive dokumantasyon.

SDK generation (TypeScript, Python, Go) otomatik. Postman collection, code samples, getting started guide — hepsini standart paketin parçası.

Sikca sorulan sorular

Public API mi internal API mi?

Public API'lar (musterilerinize sunulan) farkli kalite seviyesi gerektirir: dokumantasyon, SDK, monitoring, support. Internal API'lar (sirket icinde) daha esnek olabilir.

API versioning nasil yapiliyor?

URL path-based (/v1, /v2) veya header-based (Accept: application/vnd.api+json;v=2). Public API icin URL-based standart. Breaking change geldiginde eski version 1 yil deprecated kalir, sonra retire.

Rate limit nasil ayarliyor?

Per-user (login eden kullanici), per-IP (anonymous), per-endpoint (kritik vs. degil). Tipik degerler: 100 req/min anonymous, 1000 req/min authenticated. Plan bazinda artiyor.