Deneysel özellikler

Chargetrip, önemli yeni yetenekleri yapılandırılmış bir deneysel program aracılığıyla sunar. Şemalar ve sözleşmeler kalıcı hale gelmeden önce yaklaşan özellikleri değerlendirmeniz ve tasarımlarını etkilemeniz için size erken erişim sağlar.

Deneysel özellik türleri

• Yeni işlemler: Tamamen yeni sorgular, mutation’lar veya subscription’lar.
• Mevcut işlemlerin uzantıları: Mevcut kararlı işlemlere eklenen yeni isteğe bağlı argümanlar veya çıktı alanları.

Deneysel özellik aşamaları

Kararlı özelliklerin neleri garanti ettiğini öğrenmek için API yaşam döngüsü sayfasına bakın.

En iyi uygulamalar

• Alpha özelliklerini sandbox değerlendirmesi, kavram kanıtları ve geri bildirim için kullanın. Yine de birini canlıya alırsanız, değiştiğinde bildirim almazsınız ve uyumluluk koruması sağlanmaz.
• Beta yeteneklerini son kullanıcılara sunarsanız, yeteneğin hâlâ kararlı hale geldiğini bilmeleri için bir “beta” rozeti gösterin.

Kararlı hale geçiş yaşam döngüsü

1. Alpha’dan Beta’ya

   İşlevsellik ve şema yeterli olgunluğa ulaştığında özellik beta aşamasına geçer. Açıklama etiketi [ALPHA] yerine [BETA] olur, erişim tüm müşteriler için varsayılan olarak etkinleştirilir ve değişiklikler Sürüm Notları’nda duyurulur.

2. Beta’dan Kararlı’ya

   Güvenilirlik ve olgunluk birden fazla istemcide doğrulandığında [BETA] açıklama etiketi ve çalışma zamanı uyarıları kaldırılır ve özellik kararlı yaşam döngüsüne geçer.

Fiyatlandırma

• Deneysel olarak etiketlenmiş işlemlere yapılan istekler ücretsizdir.
• İsteğe bağlı deneysel girdi argümanları veya çıktı alanları içeren kararlı uç noktalara yapılan istekler, abonelik planınıza göre ücretlendirilir.

Programatik uyarılar

Geliştirme ekibinizi etkin trafikteki deneysel bağımlılıklardan haberdar etmek için, alpha veya beta yetenekleri kullanan API yanıtları GraphQL extensions bloğunda uyarı meta verileri döndürür:

{  "data": {    "getTruckRoute": {      "id": "dd07b4d0-6b79-11f0-bf8f-e6b813282ac3",      "status": "done"    }  },  "extensions": {    "warnings": [      {        "code": "ALPHA_FEATURE",        "path": ["getTruckRoute"],        "message": "This feature is currently in ALPHA. Visit https://developers.chargetrip.com/api-reference for more information."      }    ]  }}

{  "data": {    "vehicleMakes": {      "name": "Opel"    }  },  "extensions": {    "warnings": [      {        "code": "BETA_FEATURE",        "path": ["vehicleMakes"],        "message": "This feature is currently in BETA. Visit https://developers.chargetrip.com/api-reference for more information."      }    ]  }}