Beta Aşamasında

Geliştirici API

Kodyazar gücünü kendi projelerinize taşıyın. REST API'miz ile platformdaki içeriklere, kullanıcı verilerine ve istatistiklere programatik olarak erişin.

Genel Bakış

Kodyazar Public API v1, geliştiricilerin Kodyazar ekosistemine entegre uygulamalar oluşturmasını sağlayan bir RESTful arayüzdür. API, JSON formatında yanıt döndürür ve standart HTTP durum kodlarını (200, 400, 404, 500 vb.) kullanır.

// Örnek Bir İstek (Makale Çekme)
curl -X GET \
https://api.kodyazar.com/v1/posts/ornek-makale-slug \
-H 'Accept: application/json' \
-H 'Authorization: Bearer SIZIN_API_ANAHTARINIZ'

Kimlik Doğrulama (Authentication)

API'ye yapılan tüm istekler bir API Anahtarı (API Key) gerektirir. API anahtarlarınızı, profil ayarlarınızdaki "Geliştirici" sekmesinden oluşturabilirsiniz. Anahtarınızı isteklerinAuthorization başlığında Bearer token olarak göndermelisiniz.

Sınırlandırmalar (Rate Limits)

Servis kalitesini korumak için API kullanımında limitler uyguluyoruz:

  • Kimlik doğrulaması yapılmamış istekler: Kesinlikle reddedilir (401 Unauthorized).
  • Standart API Anahtarı: Dakikada 60 istek, günde maksimum 10.000 istek.
  • Sınır aşıldığında sistem 429 Too Many Requests HTTP durum kodu dönecektir.

Uç Noktalar (Endpoints) Özeti

HTTP MetoduUç Nokta (Endpoint)Açıklama
GET/v1/postsSon yayınlanan makaleleri sayfalayarak listeler.
GET/v1/posts/{slug}Belirtilen makalenin tüm detaylarını (HTML içerik dahil) getirir.
POST/v1/postsHesabınız üzerinden yeni bir taslak veya makale yayınlar.
GET/v1/users/{id}Kullanıcı profili ve genel istatistiklerini getirir.

Not: API şu anda kapalı beta sürecindedir. Erken erişim talebinde bulunmak için lütfen iletişim sayfasından bize ulaşın.