Qual è un buon esempio di vita reale di un'API veramente RESTful?

Ogni volta che vedi la documentazione API contenente l'URI delle risorse con cui vuoi interagire, non è RESTful. Tutti gli esempi forniti nelle altre risposte qui, contengono URI che identificano le risorse nell'API. L'unico URI che dovresti aver bisogno di conoscere per un'API è quello della risorsa home. Se dovete hard-code gli URI con cui interagire nel vostro client, l'API non è RESTful.

Invece, ogni risorsa servita dall'API dovrebbe contenere informazioni sui collegamenti e le operazioni che possono essere eseguite. Per esprimere questo, avete un paio di opzioni: Collection+JSON, Siren e Hydra. Questi tre formati differiscono in alcuni modi. I primi due richiedono che tutto il tuo JSON abbia una certa struttura per essere interpretato correttamente. Il secondo si basa su JSON-LD, che ti permette di aggiungere informazioni ipermediali a praticamente qualsiasi struttura JSON a cui puoi pensare.

La cosa importante è che con questi formati, puoi rendere ogni risorsa auto-descrittiva. Questo significa che per interagire con una risorsa, non hai bisogno di conoscere alcuna informazione "fuori banda" (documentazione esterna e simili); tutto ciò che devi sapere è nella risposta HTTP che hai appena ricevuto dal server.

La maggior parte delle API HTTP oggi non sono costruite così. Ci sono alcune API basate su JSON-LD là fuori, come NuGet v3, ma è ancora lontano dall'essere onnipresente.