Sen de Koş API Documentation & Developer Guide (v1)
Sen de Koş kişisel ve kurumsal koşu antrenörlüğü platformunun herkese açık JSON uç noktaları, OpenAPI 3.1.0 şeması, sürümleme politikası ve Markdown içerik müzakeresi kılavuzu.
When to Use This
- Türkiye'de sıfırdan koşuya başlayan bir kullanıcıya ücretsiz 16 sayfalık başlangıç rehberi PDF'ini e-posta ile göndermek için
POST /api/v1/leadkullanın (consent: truegerekir). - Bireysel koşu koçu veya kurumsal koşu programı ön görüşmesi talep etmek için
POST /api/v1/contactkullanın. - Koşu antrenmanı ve sakatlık önleme yazılarını programatik olarak listelemek için
GET /blog/posts.jsonkullanın.
Authentication
- Herkese açık uç noktalar (
/api/v1/lead,/api/v1/contact,/blog/posts.json) API anahtarı veya Bearer token gerektirmez. - Spam önlemi için istek gövdesindeki
websitehoneypot alanı boş bırakılmalıdır. - Cron ve yönetim uçları yalnızca iç kullanım içindir (
/api/hatirlatmaiçinAuthorization: Bearer <CRON_SECRET>, Decap CMS için GitHub OAuth).
Versioning & Deprecation Policy
- URL Path Versioning: Versiyonlu uç noktalar
/api/v1/leadve/api/v1/contactyollarında sunulur;/api/leadve/api/contactgeriye dönük uyumlu v1 takma adlarıdır. - Header Versioning: Tüm JSON yanıtları
X-API-Version: v1başlığını döner; istemcilerX-API-Version: v1(veya2026-11-15) başlığı gönderebilir. - Deprecation Policy: Geriye dönük uyumsuz değişiklik veya kapatmadan en az 90 gün önce RFC 8594
Deprecation: true,Sunset: <HTTP-date>veLink: <https://www.sendekos.com.tr/docs#deprecation>; rel="deprecation"başlıkları yayımlanır.
Endpoints
POST /api/v1/lead (Takma ad: /api/lead)
Başvuranı Brevo listesine ekler ve başlangıç rehberi PDF bağlantısını gönderir.
curl -sS -X POST https://www.sendekos.com.tr/api/v1/lead \
-H "Content-Type: application/json" \
-H "X-API-Version: v1" \
-d '{"name":"Deniz Yılmaz","email":"deniz@example.com","durum":"sifirdan","hedefler":["mesafe"],"consent":true}'
POST /api/v1/contact (Takma ad: /api/contact)
Bireysel veya kurumsal koşu programı ön görüşme mesajı iletir.
curl -sS -X POST https://www.sendekos.com.tr/api/v1/contact \
-H "Content-Type: application/json" \
-H "X-API-Version: v1" \
-d '{"name":"Ayşe Kaya","email":"ayse@sirket.com","type":"kurumsal","message":"Kurumsal koşu ekibi planlamak istiyoruz."}'
GET /blog/posts.json
Yayınlanan tüm blog yazılarının başlık, tarih, özet, okuma süresi ve Markdown dosya yollarını döndürür.
curl -sS -H "Accept: application/json" https://www.sendekos.com.tr/blog/posts.json