DİNLENME arasında seçti ve JSON-RPC web uygulaması için bir API geliştirmek için çalışıyorum.

API-müşteri-geliştirici bakış açısı; hangisi daha iyi? Bu, daha kolay ve anlamak için istemci geliştirmek için mi?

API her iki tarafında gelişen olduğumda daha iyi bir yöntem çağrıları ve iletişim için haritalama anlayabiliyorum çünkü ben şahsen JSON-RPC tercih ederim. Ama bu sefer sadece sunucu tarafında ve diğer geliştiriciler tarafından en iyi uygulama olarak kabul edilir bilmek geliştiriyorum.

Güncelleme 2015: buldum GERİSİ daha kolay geliştirmek ve kullanmak için bir API olan servis Web/HTTP, çünkü varolan ve olgun HTTP protokolü olduğu anlaşılmıştır hem istemci hem de sunucu olabilir kaldıraçlı tarafından API. Örneğin, yanıt kodları, başlıkları, sorgular, post organları, önbelleğe alma ve daha birçok özellik herhangi bir ek çaba ya da kurulum olmadan API tarafından kullanılır.

RPC ile temel sorun kavrama. RPC istemcileri çeşitli şekillerde uygulama hizmeti için sıkı eşleşmiş olur ve çok zor müşterileri kırmadan hizmet uygulama değiştirmek olur:

• Müşteriler yordam isimlerini bilmeleri gerekir;
• Yordam parametreleri sipariş, türleri ve sayısı önemli. Bu kolay istemci uygulamaları bozmadan sunucu tarafında yordam imza(sayıda bağımsız değişken, bağımsız değişken, değişken türleri, sipariş vb.) değiştirmek için değil;
• RPC tarzı bir şey ifşa etmiyor ama prosedür bağımsız olarak girilmelidir. Müvekkil neler yapılabileceğini belirlemek imkansız.
• vb...

DİNLENME tarzı diğer taraftan çok kolay temsilleri(HTTP başlıkları temsil) kontrol bilgi ekleyerek müşterilerine rehberi. Örneğin:

• Mümkün (hatta zorunlu) bağlantılar bu Kodu anlamları ifade olan bağlantı türleri ile ilgili açıklamalı gömmek için;
• İstemci uygulamaları belirli bir yordam adı ve bağımsız değişkenleri bağımlı olmak gerekmez. Bunun yerine, istemcileri ileti biçimleri bağlıdır. Bu özel medya biçimleri (örneğin Atom, HTML, JSON Toplama, HAL vb.) için önceden uygulanan kütüphaneleri kullanma olanağı yaratır
• Olası kolayca sadece kayıtlı (veya etki alanı) belirli bağlı kadarıyla müşterileri ilişkileri link; bozmadan URI değiştirmek için
• Olası form gibi beyan yapıları gömmek için, müşteriler eğer son kullanıcı insan ise UI yetenekleri bu açıklamaları ortaya çıkarmak için imkanı vermek;
• Önbelleğe alma desteği ek avantaj
• Standart durum kodları;
• vb...

GERİSİ tarafında çok fazla farkları ve avantajları var.