quando crei un'API, che cos'è una pratica migliore?
http://webapp/api
o
http://api.webapp/
perché?
Ho iniziato con l'API in http://webapp/api e la descrizione del servizio in http://webapp . ma ora, vorrei separare la descrizione dell'API in repository differenti, per questo motivo, sto pensando di cambiare l'API dell'URL in http://api.webapp/ .
è una buona idea / pratica?
Un vantaggio di http://webapp/api è che se si sta sviluppando il sito Web e l'api come parte della stessa base di codice, non è necessario eseguire alcuna gestione speciale per distribuire l'API: è solo una applicazione Web che devi distribuire.
Se hai utilizzato api.webapp , in questo caso, probabilmente dovresti fare qualche trattamento speciale durante l'installazione iniziale dell'applicazione.
Per http://api.webapp/ , d'altra parte, si utilizza un nome host diverso nell'URL (presupponendo che si disponga anche di un'applicazione Web in esecuzione a http://webapp/ ).
Ciò significa che potrebbe puntare a un indirizzo IP diverso - o potrebbe puntare allo stesso IP - a seconda della configurazione DNS. Quindi, usando questo, potresti avere l'API e l'applicazione web servite dallo stesso server fisico per cominciare, e in seguito avere l'opzione di separare i due, senza infrangere la tua interfaccia pubblica!
Quindi il primo potrebbe essere più semplice da configurare inizialmente, quest'ultimo ti offre più opzioni.