YouSoft dış API’si

Firma başına üretilen API anahtarıyla erişilen /v1 yüzeyi. Sunucudan sunucuya çalışır: her istek HMAC-SHA256 ile imzalanır, tarayıcıdan çağrılmaz.

• Başlangıç ve kimlik doğrulama

  Anahtar nasıl alınır, ilk istek nasıl atılır, hangi başlıklar zorunludur.

• İmzalama ve test vektörü

  Kanonik dize, dört dilde örnek ve yayımlanmış test vektörü (C#, PHP, Python, Node).

• OpenAPI referansı

  Canlı `GET /v1/openapi.yaml` sözleşmesinden render edilir.

• Hata kodları

  Dış API yüzeyinin yayımlanmış kapalı kod kümesi ve hata zarfı.

• Sorgu sözleşmesi

  Keyset sayfalama, filter operatörleri, sort beyaz listesi, include, idempotency ve retry.

• Değişiklik günlüğü ve kullanımdan kaldırma

  12 ay bildirim, Deprecation + Sunset başlıkları, sessiz davranış değişikliği yok.

• Paraşüt’ten geçiş

  Ad çakışmaları, include farkı, sayfa tavanı ve kaybolan grant’lar.