Ho un'API REST pubblica per la creazione di nuovi record del profilo aziendale nel mio sistema. La richiesta stessa è simile a questa:
{
"BusinessName" : "AName",
"CurrencyCode" : "USD"
}
Puoi vedere che la proprietà CurrencyCode della richiesta è impostata su "USD" e la nostra documentazione dell'API REST afferma erroneamente che supportiamo "USD" o "EUR" come valori per questa proprietà.
Ecco il problema, negli ultimi colloqui con l'azienda è emerso chiaramente che, sebbene in futuro possiamo supportare più codici valuta, supportiamo solo "USD", e per di più non supporteremo mai la modifica del CurrencyCode sulla richiesta dal momento che è una limitazione nel nostro settore. Il nostro codice esistente ignora il valore di "CurrencyCode" sulla richiesta e lo codifica su "USD" in tutto il nostro sistema (codice legacy).
Quindi, a causa del fatto che non supporteremo mai CurrencyCode sulla richiesta, è stata presa la decisione di rimuoverlo. Quindi, andando avanti se "CurrencyCode" è fornito sulla richiesta, continueremo a ignorarlo in modo che l'utente non ottenga un errore e l'elaborazione continui come previsto finché passa "USD". Se tuttavia codificano contro la nostra attuale documentazione API e si aspettano che il supporto sia in atto, incontreranno problemi quando il loro software tenta di utilizzare "EUR" per il codice valuta.
Gli utenti odierni dell'API non hanno alcun modo di utilizzare il codice di valuta "Eur" perché la nostra applicazione ignora questo valore. Tuttavia, direi che questo è un bug e che la rimozione di questo valore senza alcun tipo di versioning dell'api è una cattiva pratica. Asserisco che questo dovrebbe essere considerato un cambiamento decisivo.
Quindi la domanda "La rimozione della proprietà" CurrencyCode "dalla richiesta è una modifica irrisolta anche se non la supportiamo oggi (bug) e non la supporteremo mai in futuro?"