Sürümler ve değişiklik günlüğü

Sürümleme kuralı

• /v1 kararlıdır. Bir uç yayımlandıktan sonra yolu, yöntemi, scope’u, parametreleri ve gövde alanları geriye uyumsuz biçimde değişmez.
• Geriye uyumlu eklemeler (yeni uç, yeni isteğe bağlı alan, yanıta yeni alan) aynı sürümde yayımlanır ve bu sayfaya yazılır. İstemcin tanımadığı alanları yok saymalıdır.
• Geriye uyumsuz değişiklik yeni sürüm yolunda yeni uç olarak gelir (ör. /v1.1/events/{id}/join ya da /v2/…). Eski uç duyurulu bir süre (en az 6 ay) çalışmaya devam eder ve yanıtlarında şu başlıklar bulunur:
  • Deprecation: @<unix-zaman> (RFC 9745) — kaldırılacağı duyuruldu
  • Sunset: <HTTP tarihi> (RFC 8594) — bu tarihten sonra çalışmaz
  • Link: <yeni-uç>; rel="successor-version"
• Yanıt biçimi tarihi HADI-Version başlığıyla da bildirilir.
• HADİ uygulamasına gelen her yeni özellik, yayından önce API eşlemesinden geçer: ya bir scope ile API’ye açılır ya da gerekçesiyle kapalı tutulur. Açılanlar bu sayfaya eklenir.

Değişiklik günlüğü

v1 — eklemeler (geriye uyumlu)

• 2 Kasım 2026 — Webhook imzası ES256 (ECDSA P-256, HSM): webhook-signature: es256,<base64>, JWKS’de use: "webhook" EC anahtarı. (Yayın öncesi değişiklik; Ed25519 / v1a hiç yayımlanmadı.)

• 2 Kasım 2026 — Paylaşımlı yolculuk: rides.list (GET /v1/events/{id}/rides), rides.reserve (POST /v1/rides/{id}/reservations), rides.cancel (DELETE /v1/rides/{id}/reservations). rides:read / rides:write (R3, Kademe 2 incelemeli). Ücretli koltukta ödeme yalnızca HADİ uygulamasında.

v1 — 2 Kasım 2026 (ilk sürüm; yayın öncesi)

Üye adına (me.api)

• Profil ve üyeler: me.get, members.get, members.posts
• Etkinlikler: events.list, events.get, events.join (ücretli etkinlikte işlem onayı), events.leave, events.submit
• Gönderiler: posts.create, posts.delete, posts.like, posts.unlike, comments.create, comments.delete, polls.vote, media.upload
• Sosyal: members.follow, members.unfollow, members.block, members.unblock, members.mute, members.unmute
• Topluluk: communities.update
• Cüzdan ve para (Kademe 3): wallet.get, wallet.history, gifts.send, donations.orgs, donations.give, approvals.get
• Doğrudan mesajlar (Kademe 3): chats.list, chats.messages, chats.send
• Sağlık (Kademe 3): health.workouts, health.metrics, health.workouts.create

Uygulama düzeyi (app.api): public.events.list, public.events.get, bots.post

MCP (mcp.api): araçlar yukarıdaki üye uçlarından üretilir (R0–R3); araç adları MCP sayfasında.