Che cosa dico ai miei colleghi quando si lamentano che il nostro sito Web basato su Rails ha un'API ma non è un servizio Web?

Le persone sono pigre e / o ignoranti.

"Servizio Web" non è sinonimo di SOAP e WSDL. Non è l'unico modo per farlo.

L'esperimento interessante da eseguire sarebbe quello di fornire una versione basata SOAP e WSDL dell'API REST. Strumento per vedere quanto ognuno è usato.

Scommetto che, nel tempo, l'API REST otterrà più utenti grazie alla sua semplicità. Finché entrambi sono pubblicizzati e documentati altrettanto bene, il più semplice vincerà.

Indicali su Wikipedia e indica la parte "Servizi Web" dopo "RESTful" e dì "è troppo!" Servizi Web RESTful su Wikipedia

Ha una breve descrizione di SOAP in là. Oppure puoi puntarli su questo articolo che va su SOAP, REST e i loro casi d'uso.

Quando dicono di volere SOAP, menzionano quali funzionalità SOAP sono davvero dopo? Quando eseguo servizi Web Java e client .Net, personalmente preferisco SOAP in modo che VS possa generare una serie di classi .NET che gestiscono automaticamente tutto il materiale di rete, l'analisi XML e la mappatura degli oggetti, che mentre non è t difficile, è un PITA. Questo risolve i problemi pigri. Se ci sono ALTRE ragioni, potendo ricorrere a un SMTP o ad un altro livello di trasporto, quale sì, ho effettivamente fatto con SOAP. Hanno un vecchio bus di servizio che non supporta REST? La tua interfaccia è effettivamente REST? (ok, l'ho detto prima). Ci sono molte cose in SOAP che sono indirizzate in REST con il vecchio argomento YAGNI, che di solito è vero, ma non sempre.

Buona fortuna.