È una buona idea creare un'API in modo tale che i clienti possano inviare documenti JSON di forma diversa alla stessa Risorsa? Lascia che ti dia un esempio e una spiegazione del perché ti sto chiedendo questo.
Spero di creare un'API che dovrebbe servire clienti negli Stati Uniti e altri clienti in tutto il mondo. Ho una risorsa specifica nella mia api che assomiglia a questa:
POST /api/addresses/validate
I client chiamano questa risorsa API quando vogliono convalidare un indirizzo di spedizione. L'unico problema è che la struttura degli indirizzi per i clienti statunitensi è completamente diversa da quella degli altri paesi del mondo. Poiché la maggior parte dei framework web api mappa l'indirizzo serial json dalla richiesta http a un controller o servizio, devo specificare la struttura dell'indirizzo JSON per i miei clienti per sapere come utilizzare correttamente la mia API. Cosa faccio quando la struttura dell'indirizzo è diversa per le diverse regioni del mondo? Creo un oggetto generico con un gruppo di campi che gestiscono tutte le regioni? Creo una risorsa separata per la convalida degli indirizzi per ogni regione? Sarebbe meglio creare un'API ospitata completamente separata con diverse strutture di oggetti per ogni regione del mondo?
Qualsiasi idea sarebbe utile!