REST API最佳實(shí)踐：如何接受參數(shù)值列表作為輸入我們正在推出一個(gè)新的REST API，我想要一些關(guān)于如何格式化輸入?yún)?shù)的最佳實(shí)踐的社區(qū)意見：現(xiàn)在，我們的API非常以JSON為中心（僅返回JSON）。關(guān)于我們是否想要/需要返回XML的爭論是一個(gè)單獨(dú)的問題。由于我們的API輸出是以JSON為中心的，我們一直在走一條路，我們的輸入有點(diǎn)以JSON為中心，我一直在想這可能對某些人來說很方便，但總的來說很奇怪。例如，要獲得一些產(chǎn)品詳細(xì)信息，我們可以立即提取多個(gè)產(chǎn)品：http://our.api.com/Product?id=["101404","7267261"]我們應(yīng)該簡化為：http://our.api.com/Product?id=101404,7267261或者有JSON輸入方便嗎？更多的痛苦？我們可能希望接受這兩種風(fēng)格，但這種靈活性是否會(huì)導(dǎo)致更多的混亂和頭痛（可維護(hù)性，文檔等）？更復(fù)雜的情況是我們想要提供更復(fù)雜的輸入。例如，如果我們想在搜索上允許多個(gè)過濾器：http://our.api.com/Search?term=pumas&filters={"productType":["Clothing","Bags"],"color":["Black","Red"]}我們不一定要將過濾器類型（例如productType和顏色）作為請求名稱，如下所示：http://our.api.com/Search?term=pumas&productType=["Clothing","Bags"]&color=["Black","Red"]因?yàn)槲覀兿胍獙⑺羞^濾器輸入組合在一起。最后，這真的很重要嗎？可能有很多JSON實(shí)用程序，輸入類型并不重要。我知道我們的JavaScript客戶端對API進(jìn)行AJAX調(diào)用可能會(huì)欣賞JSON輸入以使他們的生活更輕松。