Domande con tag 'api-design'

6
risposte

Molte piccole richieste rispetto a poche grandi richieste (API Design)

Attualmente sto lavorando a un progetto con un'organizzazione come segue: Cliente : recupera i dati dal server principale tramite REST API. Server : richiede dati da vari altri server tramite API di terze parti API di terze parti : se...
posta 24.02.2015 - 22:46
5
risposte

Come descrivere un cambiamento architettonico che infrange intenzionalmente gli standard REST?

Sto proponendo modifiche a un progetto software molto scarsamente architettato che soffre di una moltitudine di problemi. Ad un livello elevato il progetto utilizza Angular sul front-end e utilizza varie API REST; che è tutto fantastico (non ved...
posta 21.06.2018 - 16:09
1
risposta

Perché il metodo PATCH non è idempotente?

Mi stavo chiedendo di questo. Supponiamo di avere una risorsa user con i campi id e name . Se voglio aggiornare un campo, potrei semplicemente fare una richiesta PATCH alla risorsa come questa PATCH /users/42 {"name": "john do...
posta 24.10.2014 - 10:41
1
risposta

null rispetto alla chiave mancante nella risposta all'API REST [chiusa]

Dì nella mia domanda, alcuni utenti ci danno il loro cognome e altri no. In una risposta API REST, quale corpo è preferito: Con un valore "null": {"firstName": "Bob", "lastName": null} O solo una chiave mancante: {"firstName": "Bob"}...
posta 26.05.2015 - 21:01
3
risposte

API REST - L'API dovrebbe restituire oggetti JSON nidificati?

Quando si tratta di API JSON è buona norma appiattire le risposte ed evitare oggetti JSON annidati? Ad esempio, diciamo che abbiamo un'API simile a IMDb ma per i videogiochi. Ci sono un paio di entità, Game, Platform, ESRBRating e GamePlatfor...
posta 09.02.2015 - 01:16
3
risposte

API RESTful: verbi HTTP con URL condivisi o specifici?

Durante la creazione di una API RESTful , dovrei usare i verbi HTTP sullo stesso URL (quando è possibile) o dovrei creare un URL specifico per azione? Ad esempio: GET /items # Read all items GET /items/:id # Read one item POS...
posta 15.11.2014 - 21:50
4
risposte

Quando si crea un'API dovrei attenermi a piccole funzioni e molte chiamate o poche chiamate e grandi funzioni?

Ho una piattaforma di binari che mantengo. Ha un sacco di diverse applicazioni web costruite su di esso. Tuttavia ora un cliente chiede un'API in modo che possano mantenere gli utenti sul proprio sito, ma approfittare di alcune delle attività au...
posta 22.01.2013 - 20:12
3
risposte

Va bene restituire HTML da un'API JSON?

Nel mio progetto corrente sono responsabile dell'implementazione di un servizio che prevede il consumo di API RESTful appena create, documentate come supporto esclusivo di JSON. Il client effettua costantemente richieste con l'intestazione di...
posta 10.08.2013 - 09:28
10
risposte

Progettazione dell'API: approccio concreto o astratto - best practice?

Quando si discutono le API tra i sistemi (a livello di business) ci sono spesso due punti di vista diversi nel nostro team: alcune persone preferiscono un approccio astratto più - diciamo - generico , altro ancora approccio "concreto". Esemp...
posta 11.09.2013 - 22:46
2
risposte

Devo creare i miei codici di stato HTTP? (a la Twitter 420: Migliora la tua calma)

Attualmente sto implementando un'API HTTP, la mia prima volta. Ho passato molto tempo a guardare la pagina di Wikipedia per i codici di stato HTTP, perché sono determinato a implementare i codici corretti per le situazioni giuste. In questa p...
posta 11.11.2013 - 00:47