Edistynyt🚀 Aloitus

API-versionointistrategia

Valitse API-versionointimalli ja tee konkreettinen kayttoonottosuunnitelma.

Prompti

Suunnittele API-versionointi tälle palvelulle.

Kuvaus:
[KUVAUS]

Tuota:
1) suositeltu malli (URL/header/semver) perusteluineen
2) miten breaking changes kasitellaan
3) deprekaatiopolitiikka
4) dokumentaation paivitysmalli
5) asiakasviestinnan runko

Suomenkieliset vinkit

  • Sisallyta aina asiakasviestinta, muuten suunnitelma jaa tekniseksi

Muuttujat

Korvaa nämä hakasulkeissa olevat muuttujat omilla tiedoillasi:

  • [KUVAUS]

Esimerkki

Täytetty prompti

Suunnittele API-versionointi tälle palvelulle.

Kuvaus:
Julkinen maksu-API, 50 integraatiokumppania, muutoksia kvartaaleittain

Tulos

Saat versionointimallin, joka minimoi asiakkaiden rikkoutumiset.

Vinkit

  • Kerro asiakasmaara ja integraatioiden kriittisyys
  • Pyydä deprekaatioaikataulu
  • Tee viestinta osaksi suunnitelmaa

Milloin käyttää

  • Julkinen API laajenee
  • Breaking changeja tulossa
  • Versionointi ei ole yhdenmukainen