Come rendere l'api del modulo con gli aggiornamenti della versione principale indolore?

Naviga le tue risposte
-1

Ho un cms con alcuni moduli, e ora sto lavorando su un grande aggiornamento per questo con la nuova API. E provo tristezza quando scrivo aggiornamenti per ogni singolo modulo. Troppe cose sono cambiate in questo momento.

Come posso evitarlo in futuro?
Esistono raccomandazioni per una buona progettazione di API?

Google mi dà consigli solo per creare moduli con api per i cms concreti

    
posta ArtyGrand 30.03.2017 - 13:11
fonte

1 risposta

0

Segui le seguenti pratiche lavorative:

  • Quando progetti la tua API, assicurati di pensare al futuro
  • Aggiungi API nuovi punti di ingresso e, se possibile, deprecati quelli esistenti tra le versioni anziché sostituirle.
  • Considera una o entrambe le modalità di compatibilità con le versioni precedenti o l'anteprima della nuova API come aggiornamento secondario con la deprecazione dei nodi API ritirati per alcune versioni minori prima del maggiore.
  • Includi le informazioni sulla versione dell'API nella tua API in modo che i clienti possano verificare la compatibilità o negoziare l'API.
  • Se possibile, considera la possibilità di fornire strumenti di porting API che mapperanno automaticamente le chiamate API esistenti nella nuova API puntare ad almeno il 90% di probabilità di successo e clean failure
risposta data 30.03.2017 - 13:45
fonte

Leggi altre domande sui tag

Come mai il comitato per gli standard C ++ introduce una parola chiave come nullptr e se la cava? [chiuso] Nome dell'algoritmo per il caricamento progressivo dei dati in punti chunked?