Tərtibatçılar · Connect v1

Buraxılış qeydləri

CoSuite Connect v1 müqaviləsində və @cosuite/connect paketində 1.0-dan 1.8-ə qədər dəyişikliklər. Hər versiya geriyə uyğundur.

Aşağıdakı bütün versiyalar v1 müqaviləsinə (cosuite-connect/1.0) aiddir və geriyə uyğundur: əvvəlki versiya üçün qurulmuş tətbiq dəyişiklik etmədən işləməyə davam edir. Yeni funksiyalar yeni istəyə bağlı sahələr və ya yeni imkanlar vasitəsilə yalnız istəyə görə aktivləşir. Bax: versiyalama qaydaları.

1.8.0: müştəri API şlüzü

28 oktyabr 2026

  • Müştərilər modulunuzun API-sini öz CoSuite açarları ilə https://api.cosuite.io/v1/apps/{app}/{path} ünvanından çağırır. Şlüz sorğunu tətbiqinizə Connect imzası və bu başlıqlarla ötürür: X-CoSuite-Gateway, X-CoSuite-Tenant, X-CoSuite-Scopes, X-CoSuite-Api-Key-Id. Bax: Şlüz və müştəri API-si.
  • Yeni ixraclar: verifyGatewayRequest, signGatewayRequest, gatewayServer.
  • Uyğunluq testi api tərifi olan modulların parametrsiz GET əməliyyatlarını üç formada çağırır: test biznesi ilə cavab gözlənilir, naməlum biznes ilə 404 tenant_not_found gözlənilir, imzasız sorğuda 401 gözlənilir.
  • cosuite təhlükəsizlik sxemi yekunlaşdı (bearer, CoSuite API açarı).

1.7.0: modul tərifi

28 oktyabr 2026

  • Modullar özlərini manifestdə təsvir edə bilər: description, features, api (OpenAPI 3.1 sənədi və scope-lar), webhooks, provides, dataCategories və markets. Bütün sahələr istəyə bağlıdır. Bax: modul tərifi.
  • Uyğunluq testi modul tərifini (yalnız doldurduğun sahələri) yoxlayır, hər modulun OpenAPI sənədini yükləyib yoxlayır: hər əməliyyat security: [{ "cosuite": [...] }] vasitəsilə elan olunmuş scope tələb etməlidir.
  • Yeni eksportlar: checkModuleDefinitions, checkOpenApi, loadOpenApi, PROVIDES, DATA_CATEGORIES.
  • Paket MIT lisenziyası ilə dərc olunur.

1.6.0: bağlanmış hesabların ayrılması

27 oktyabr 2026

  • Bağlama kodu ilə bağlanmış hesab üçün DELETE /tenants/{tenantId} artıq onu silmir. Hesab ayrılır: məlumatlar, istifadəçilər və giriş tətbiqində qalır, ödəniş sənə qayıdır, cavab isə { "deleted": false, "detached": true } olur. Bax: DELETE /tenants.
  • Bağlanmış hesab heç vaxt test hesabı sayılmır.

1.5.0: mövcud hesabların bağlanması

27 oktyabr 2026

  • Yeni link imkanı: tətbiqindən artıq istifadə edən biznes yeni, boş hesab almaq əvəzinə mövcud hesabını birdəfəlik kodla CoSuite-ə qoşa bilər. POST /tenants link: { code } daşıyır. Bax: mövcud hesabın bağlanması.
  • Yeni xəta kodu invalid_link_code (409).
  • Uyğunluq: hər tətbiq naməlum bağlama koduna 409 invalid_link_code ilə cavab verməli və hesab yaratmamalıdır.

1.4.0 və 1.4.1

27 oktyabr 2026

  • Partnyor müqaviləsində dəyişiklik yoxdur. Paketdə daxili klient əlavələri.

1.3.0: müştəri sinxronizasiyası

26 oktyabr 2026

  • Yeni customers imkanı: GET /tenants/{tenantId}/customers (cursor ilə səhifələmə) və customer.upserted, customer.deleted hadisələri. Müştərilərin CoSuite-in müştəri siyahısında tətbiqinin nişanı ilə görünür. Bax: müştərilər.
  • Müqavilənin əsas URL-ləri dəqiqləşdirildi: müqavilənin CoSuite tərəfi https://api.cosuite.io/connect/v1 ünvanındadır.

1.2.1: giriş səhifəsi vasitəsilə SSO

26 oktyabr 2026

  • Tətbiqin redirect ünvanına keçməzdən əvvəl sessiyasını öz giriş səhifəsi vasitəsilə (URL fraqmentində birdəfəlik bilet) qura biləcəyi dəqiqləşdirildi. Uyğunluq testi hər iki axını qəbul edir. Bax: SSO.

1.1.0 və 1.2.0

26 oktyabr 2026

  • Partnyor müqaviləsində dəyişiklik yoxdur. Paketə müqavilə snapshot-u və pozucu dəyişikliklərin avtomatik yoxlaması (contract:check) əlavə edildi.

1.0.0: ilk buraxılış

26 oktyabr 2026

  • Zaman pəncərəsi və request-id təkrarına qarşı qoruma ilə HMAC-SHA256 sorğu imzası, xəta zərfi və kodları.
  • Tətbiq endpoint-ləri: manifest, health, tenants (yaratma, oxuma, yeniləmə, silmə), versiyalı entitlement-lər, üzvlər, istifadə, xülasə, SSO.
  • CoSuite endpoint-ləri: entitlement-lər, hadisələr, JWKS.
  • ES256 JWT və JWKS ilə SSO.
  • @cosuite/connect: imzalama, sxemlər, SSO, klientlər, server qabığı, istinad tətbiqi və uyğunluq testi.