2009-03-23 19 views
71

पर जेएसओएन सेवा वापसी क्या होनी चाहिए मैं सी # (.ashx फ़ाइल) में एक JSON सेवा लिख ​​रहा हूं। सेवा के सफल अनुरोध पर मैं कुछ JSON डेटा लौटाता हूं। अगर अनुरोध विफल रहता है, या तो क्योंकि एक अपवाद फेंक दिया गया था (उदा। डेटाबेस टाइमआउट) या क्योंकि अनुरोध किसी भी तरह से गलत था (उदाहरण के लिए डेटाबेस में मौजूद कोई आईडी तर्क के रूप में नहीं दी गई थी) सेवा को कैसे प्रतिसाद देना चाहिए? क्या HTTP स्टेटस कोड समझदार हैं, और यदि कोई हो, तो क्या मुझे कोई डेटा वापस करना चाहिए?विफलता/त्रुटि

मुझे उम्मीद है कि सेवा मुख्य रूप से jQuery.form प्लगइन का उपयोग करके jQuery से बुलाया जाएगा, क्या jQuery या इस प्लगइन में त्रुटि प्रतिक्रिया को संभालने का कोई डिफ़ॉल्ट तरीका है?

संपादित करें: मैं तय कर लिया है मैं इस्तेमाल करेंगे jQuery + .ashx + HTTP [स्थिति कोड] सफलता पर मैं JSON वापस आ जाएंगे, लेकिन त्रुटि पर मैं वापस आ जाएंगे, एक स्ट्रिंग, के रूप में यह प्रतीत होता है कि यह है कि क्या jQuery.ajax के लिए त्रुटि विकल्प की उम्मीद है।

उत्तर

31

आपके द्वारा लौटाए गए HTTP स्थिति कोड को होने वाली त्रुटि के प्रकार पर निर्भर होना चाहिए। यदि डेटाबेस में कोई आईडी मौजूद नहीं है, तो 404 लौटाएं; अगर किसी उपयोगकर्ता को अजाक्स कॉल करने के लिए पर्याप्त विशेषाधिकार नहीं हैं, तो 403 लौटाएं; यदि रिकॉर्ड खोजने में सक्षम होने से पहले डेटाबेस का समय समाप्त हो गया है, तो 500 (सर्वर त्रुटि) लौटाएं।

jQuery स्वचालित रूप से ऐसे त्रुटि कोड का पता लगाता है, और आपके अजाक्स कॉल में परिभाषित कॉलबैक फ़ंक्शन चलाता है। प्रलेखन: http://api.jquery.com/jQuery.ajax/

एक $.ajax त्रुटि कॉलबैक की कमी उदाहरण:

$.ajax({ 
    type: 'POST', 
    url: '/some/resource', 
    success: function(data, textStatus) { 
    // Handle success 
    }, 
    error: function(xhr, textStatus, errorThrown) { 
    // Handle error 
    } 
}); 
+3

कोई त्रुटि कोड आपको लगता है कि अगर कोई अमान्य डेटा प्रदान करता है तो मुझे वापस लौटना चाहिए, जैसे एक पूर्णांक की आवश्यकता होती है? या एक अवैध ईमेल पता? – thatismatt

+0

500 रेंज में कुछ, समान सर्वर साइड कोड त्रुटि – annakata

+7

जैसा कि 500 ​​रेंज एक सर्वर त्रुटि है, लेकिन सर्वर पर कुछ भी गलत नहीं हुआ है। उन्होंने एक बुरा अनुरोध किया, तो क्या यह 400 रेंज में नहीं होना चाहिए? – thatismatt

15

HTTP स्थिति कोड का उपयोग करना ऐसा करने का एक शानदार तरीका होगा, लेकिन यह सुझाव देगा कि आप संसाधन यूआरआई का उपयोग करके बाकी इंटरफ़ेस को रीस्टफुल करें।

सच में, इंटरफ़ेस को अपनी पसंद के अनुसार परिभाषित करें (उदाहरण के लिए, त्रुटि के साथ संपत्ति का विवरण दें, और एचटीएमएल का एक हिस्सा जो इसे समझाता है, आदि), लेकिन एक बार जब आप किसी चीज़ पर फैसला कर लेंगे एक प्रोटोटाइप में काम करता है, निर्दयी रूप से संगत हो।

+0

मुझे पसंद है कि तुम क्या सुझाव दे रहे हैं, मैं यह सोचते हैं रहा हूँ आपको लगता है कि मैं JSON तो लौट जाना चाहिए? कुछ ऐसा: {त्रुटि: {संदेश: "एक त्रुटि हुई", विवरण: "ऐसा हुआ क्योंकि यह सोमवार है।"}} – thatismatt

+0

@ थैटिस्मैट - यह काफी उचित है, अगर त्रुटियां हमेशा घातक होती हैं। अधिक ग्रैन्युलरिटी के लिए, 'त्रुटि' को एक (संभवतः खाली) सरणी बनाना और 'fatal_error: bool' पैरामीटर जोड़ना आपको काफी लचीलापन देगा। –

+1

ओह, और जब उपयोग करने के लिए +1 और जब उपयोग न करने के लिए रीस्टफुल प्रतिक्रियाएं। :-) –

2

मुझे लगता है कि अगर आप बस एक अपवाद बबल करते हैं, तो इसे jQuery callback that is passed in for the 'error' option में संभाला जाना चाहिए। (हम सर्वर अप पर केंद्रीय अपवाद पर इस अपवाद को भी लॉग करते हैं)। कोई विशेष HTTP त्रुटि कोड आवश्यक नहीं है, लेकिन मैं यह देखने के लिए उत्सुक हूं कि अन्य लोग भी क्या करते हैं।

यह मैं क्या कर रहा है, लेकिन है कि बस अपना $ .02

आप RESTful हो सकता है और वापसी त्रुटि कोड, मानक कोड W3C द्वारा निर्धारित करने के लिए छड़ी करने की कोशिश करने जा रहे हैं: http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html

0

मुझे नहीं लगता कि आपको किसी भी HTTP त्रुटि कोड को वापस करना चाहिए, बल्कि कस्टम अपवाद जो एप्लिकेशन के क्लाइंट एंड के लिए उपयोगी हैं, इसलिए इंटरफ़ेस जानता है कि वास्तव में क्या हुआ था। मैं 404 त्रुटि कोड या उस प्रकृति के लिए कुछ वास्तविक मुद्दों को हल और मास्क नहीं करता।

+0

क्या आप सुझाव दे रहे हैं कि कुछ गलत होने पर भी मैं 200 लौटाता हूं? आपका मतलब "कस्टम अपवाद" क्या है? क्या आपका मतलब है कि JSON का एक टुकड़ा त्रुटि का वर्णन करता है? – thatismatt

+4

ब्लाह, http कोड लौटने का मतलब यह नहीं है कि आप त्रुटि विवरण संदेश भी वापस नहीं कर पाएंगे। 200 का रिटर्निंग मूर्खतापूर्ण नहीं होगा, गलत का उल्लेख न करें। – StaxMan

+0

@StaxMan से सहमत - हमेशा सर्वोत्तम स्थिति कोड लौटाएं लेकिन लौटने की जानकारी में विवरण शामिल करें – schmoopy

52

अपनी स्थिति के लिए सर्वोत्तम प्रथाओं में कुछ अंतर्दृष्टि के लिए this question देखें।

टॉपलाइन सुझाव (कहा गया लिंक से) एक प्रतिक्रिया संरचना (सफलता और विफलता दोनों के लिए) को मानकीकृत करना है कि आपका हैंडलर सर्वर परत पर सभी अपवादों को पकड़ रहा है और उन्हें उसी संरचना में परिवर्तित कर रहा है।उदाहरण (this answer से) के लिए:

{ 
    success:false, 
    general_message:"You have reached your max number of Foos for the day", 
    errors: { 
     last_name:"This field is required", 
     mrn:"Either SSN or MRN must be entered", 
     zipcode:"996852 is not in Bernalillo county. Only Bernalillo residents are eligible" 
    } 
} 

यह दृष्टिकोण stackoverflow का उपयोग करता है (यदि आप सोच रहे थे कि कैसे दूसरों को बात इस तरह का है) है, लिखने मतदान जैसे कार्य "Success" और "Message" फ़ील्ड हैं, की अगर वोट अनुमति दी गई थी या नहीं:

{ Success:true, NewScore:1, Message:"", LastVoteTypeId:3 } 

@Phil.H pointed out रूप में, आप जो कुछ भी आप चुनते में अनुरूप होना चाहिए। ऐसा करना आसान है (जैसा कि विकास में सब कुछ है!)।

उदाहरण के लिए, आप के बजाय लगातार किया जा रहा है और लौटने

{ Success: false, Message: "Can only comment once every blah..." } 

अतः एक सर्वर अपवाद (HTTP 500) फेंक और उनके error कॉलबैक में इसके शिकार हो सकते की इतने पर बहुत जल्दी टिप्पणियां सबमिट करते हैं,।

jQuery + .ashx + HTTP [स्टेटस कोड] आईएमओ का उपयोग करने के लिए जितना अधिक "सही लगता है" यह आपके क्लाइंट-साइड कोड बेस पर अधिक जटिलता जोड़ देगा। यह समझें कि jQuery त्रुटि कोड "पहचान" नहीं बल्कि बल्कि सफलता कोड की कमी का पता लगाता है। JQuery के साथ http प्रतिक्रिया कोड के आसपास क्लाइंट को डिज़ाइन करने का प्रयास करते समय यह एक महत्वपूर्ण भेद है। आपको केवल दो विकल्प मिलते हैं (क्या यह एक "सफलता" या "त्रुटि" थी?), जिसे आपको अपने आप आगे बढ़ाना है। यदि आपके पास वेबसाइटों की एक छोटी संख्या को चलाने वाली वेबसाइटों की एक छोटी संख्या है तो यह ठीक हो सकता है, लेकिन कुछ भी बड़े पैमाने पर गन्दा हो सकता है।

HTTP स्थिति कोड को अनुकूलित करने के बजाय कस्टम ऑब्जेक्ट को वापस करने के लिए .asmx वेब सेवा (या उस मामले के लिए डब्ल्यूसीएफ) में यह अधिक स्वाभाविक है। इसके अलावा आपको मुफ्त में जेएसओएन क्रमबद्धता मिलती है।

+1

वैध दृष्टिकोण, केवल एक नाइटपिक: उदाहरण वैध JSON (कुंजी नामों के लिए डबल कोट्स गायब नहीं हैं) – StaxMan

+1

यही वह है जो मैं करता था, लेकिन आपको वास्तव में http स्टेटस कोड का उपयोग करना चाहिए, यही वह है जो वे हैं (विशेष रूप से यदि आप रीस्टफुल सामान कर रहे हैं) – Eva

+0

मुझे लगता है कि यह दृष्टिकोण निश्चित रूप से मान्य है - http स्थिति कोड उपयोगी सामान कर रहे हैं, लेकिन जब आप कहते हैं, तो आप इतनी उपयोगी नहीं हैं कि आप एक स्क्रिप्ट को एपीआई कॉल कर रहे हैं जिसमें डेटाबेस क्वेरी है। यहां तक ​​कि जब डेटाबेस क्वेरी एक त्रुटि देता है, तो भी http स्थिति कोड 200 होगा। इस मामले में, मैं आमतौर पर 'सफलता' कुंजी का उपयोग यह इंगित करने के लिए करता हूं कि MySQL क्वेरी सफल रही है या नहीं :) – Terry

2

मैं निश्चित रूप से त्रुटि स्थिति का वर्णन करने वाले JSON ऑब्जेक्ट के साथ 500 त्रुटि लौटा दूंगा, how an ASP.NET AJAX "ScriptService" error returns के समान। मेरा मानना ​​है कि यह काफी मानक है। संभावित रूप से अप्रत्याशित त्रुटि स्थितियों को संभालने के दौरान यह स्थिरता निश्चित रूप से अच्छी है।

इसके अलावा, क्यों न केवल .NET में अंतर्निहित कार्यक्षमता का उपयोग करें, यदि आप इसे सी # में लिख रहे हैं? डब्ल्यूसीएफ और एएसएमएक्स सेवाएं पहिया को पुनर्निर्मित किए बिना जेएसओएन के रूप में डेटा को क्रमबद्ध करना आसान बनाती हैं।

+0

मैं नहीं करता लगता है कि इस संदर्भ में 500 त्रुटि कोड का उपयोग किया जाना चाहिए। विनिर्देश के आधार पर: http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html, 400 (खराब अनुरोध) भेजने का सबसे अच्छा विकल्प है। 500 त्रुटि एक अनचाहे अपवाद के लिए अधिक उपयुक्त है। –

1

उपयोगकर्ता की आपूर्ति अमान्य डेटा है, तो यह निश्चित रूप से होना चाहिए एक 400 Bad Request (अनुरोध बुरा वाक्य रचना शामिल है या पूरा नहीं किया जा सकता है।)

+0

400 रेंज में से कोई भी स्वीकार्य है और 422 डेटा के लिए सबसे अच्छा विकल्प है जिसे संसाधित नहीं किया जा सकता – jamesc

2

रेल scaffolds त्रुटियों के इन प्रकार के लिए 422 Unprocessable Entity का उपयोग करें। अधिक जानकारी के लिए RFC 4918 देखें।

3

मैंने इस समस्या को हल करने में कुछ घंटे व्यतीत किए हैं। मेरा समाधान निम्न इच्छाओं/आवश्यकताओं पर आधारित है:

  • सभी JSON नियंत्रक कार्यों में पुनरावर्तित बॉयलरप्लेट त्रुटि हैंडलिंग कोड नहीं है।
  • HTTP (त्रुटि) स्थिति कोड को सुरक्षित रखें। क्यूं कर? क्योंकि उच्च स्तर की चिंताओं को निम्न स्तर के कार्यान्वयन को प्रभावित नहीं करना चाहिए।
  • सर्वर पर त्रुटि/अपवाद होने पर JSON डेटा प्राप्त करने में सक्षम हो। क्यूं कर? क्योंकि मुझे समृद्ध त्रुटि जानकारी चाहिए। जैसे त्रुटि संदेश, डोमेन विशिष्ट त्रुटि स्थिति कोड, स्टैक ट्रेस (डीबग/विकास पर्यावरण में)।
  • उपयोग की आसानी क्लाइंट पक्ष - jQuery का उपयोग कर बेहतर।

मैं एक हैंडलरर एट्रिब्यूट बनाता हूं (विवरण के स्पष्टीकरण के लिए कोड टिप्पणियां देखें)। "उपयोग" सहित कुछ विवरण छोड़ दिए गए हैं, इसलिए कोड संकलित नहीं हो सकता है। मैं फिल्टर इस तरह Global.asax.cs में आवेदन आरंभीकरण के दौरान वैश्विक फिल्टर करने के लिए जोड़ें:

GlobalFilters.Filters.Add(new UnikHandleErrorAttribute()); 

विशेषता:

namespace Foo 
{ 
    using System; 
    using System.Diagnostics; 
    using System.Linq; 
    using System.Net; 
    using System.Reflection; 
    using System.Web; 
    using System.Web.Mvc; 

    /// <summary> 
    /// Generel error handler attribute for Foo MVC solutions. 
    /// It handles uncaught exceptions from controller actions. 
    /// It outputs trace information. 
    /// If custom errors are enabled then the following is performed: 
    /// <ul> 
    /// <li>If the controller action return type is <see cref="JsonResult"/> then a <see cref="JsonResult"/> object with a <c>message</c> property is returned. 
    ///  If the exception is of type <see cref="MySpecialExceptionWithUserMessage"/> it's message will be used as the <see cref="JsonResult"/> <c>message</c> property value. 
    ///  Otherwise a localized resource text will be used.</li> 
    /// </ul> 
    /// Otherwise the exception will pass through unhandled. 
    /// </summary> 
    [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method)] 
    public sealed class FooHandleErrorAttribute : HandleErrorAttribute 
    { 
    private readonly TraceSource _TraceSource; 

    /// <summary> 
    /// <paramref name="traceSource"/> must not be null. 
    /// </summary> 
    /// <param name="traceSource"></param> 
    public FooHandleErrorAttribute(TraceSource traceSource) 
    { 
     if (traceSource == null) 
     throw new ArgumentNullException(@"traceSource"); 
     _TraceSource = traceSource; 
    } 

    public TraceSource TraceSource 
    { 
     get 
     { 
     return _TraceSource; 
     } 
    } 

    /// <summary> 
    /// Ctor. 
    /// </summary> 
    public FooHandleErrorAttribute() 
    { 
     var className = typeof(FooHandleErrorAttribute).FullName ?? typeof(FooHandleErrorAttribute).Name; 
     _TraceSource = new TraceSource(className); 
    } 

    public override void OnException(ExceptionContext filterContext) 
    { 
     var actionMethodInfo = GetControllerAction(filterContext.Exception); 
     // It's probably an error if we cannot find a controller action. But, hey, what should we do about it here? 
     if(actionMethodInfo == null) return; 

     var controllerName = filterContext.Controller.GetType().FullName; // filterContext.RouteData.Values[@"controller"]; 
     var actionName = actionMethodInfo.Name; // filterContext.RouteData.Values[@"action"]; 

     // Log the exception to the trace source 
     var traceMessage = string.Format(@"Unhandled exception from {0}.{1} handled in {2}. Exception: {3}", controllerName, actionName, typeof(FooHandleErrorAttribute).FullName, filterContext.Exception); 
     _TraceSource.TraceEvent(TraceEventType.Error, TraceEventId.UnhandledException, traceMessage); 

     // Don't modify result if custom errors not enabled 
     //if (!filterContext.HttpContext.IsCustomErrorEnabled) 
     // return; 

     // We only handle actions with return type of JsonResult - I don't use AjaxRequestExtensions.IsAjaxRequest() because ajax requests does NOT imply JSON result. 
     // (The downside is that you cannot just specify the return type as ActionResult - however I don't consider this a bad thing) 
     if (actionMethodInfo.ReturnType != typeof(JsonResult)) return; 

     // Handle JsonResult action exception by creating a useful JSON object which can be used client side 
     // Only provide error message if we have an MySpecialExceptionWithUserMessage. 
     var jsonMessage = FooHandleErrorAttributeResources.Error_Occured; 
     if (filterContext.Exception is MySpecialExceptionWithUserMessage) jsonMessage = filterContext.Exception.Message; 
     filterContext.Result = new JsonResult 
     { 
      Data = new 
      { 
       message = jsonMessage, 
       // Only include stacktrace information in development environment 
       stacktrace = MyEnvironmentHelper.IsDebugging ? filterContext.Exception.StackTrace : null 
      }, 
      // Allow JSON get requests because we are already using this approach. However, we should consider avoiding this habit. 
      JsonRequestBehavior = JsonRequestBehavior.AllowGet 
     }; 

     // Exception is now (being) handled - set the HTTP error status code and prevent caching! Otherwise you'll get an HTTP 200 status code and running the risc of the browser caching the result. 
     filterContext.ExceptionHandled = true; 
     filterContext.HttpContext.Response.StatusCode = (int)HttpStatusCode.InternalServerError; // Consider using more error status codes depending on the type of exception 
     filterContext.HttpContext.Response.Cache.SetCacheability(HttpCacheability.NoCache); 

     // Call the overrided method 
     base.OnException(filterContext); 
    } 

    /// <summary> 
    /// Does anybody know a better way to obtain the controller action method info? 
    /// See http://stackoverflow.com/questions/2770303/how-to-find-in-which-controller-action-an-error-occurred. 
    /// </summary> 
    /// <param name="exception"></param> 
    /// <returns></returns> 
    private static MethodInfo GetControllerAction(Exception exception) 
    { 
     var stackTrace = new StackTrace(exception); 
     var frames = stackTrace.GetFrames(); 
     if(frames == null) return null; 
     var frame = frames.FirstOrDefault(f => typeof(IController).IsAssignableFrom(f.GetMethod().DeclaringType)); 
     if (frame == null) return null; 
     var actionMethod = frame.GetMethod(); 
     return actionMethod as MethodInfo; 
    } 
    } 
} 

मैं उपयोग की क्लाइंट साइड आसानी के लिए निम्नलिखित jQuery प्लगइन विकसित किया है :

(function ($, undefined) { 
    "using strict"; 

    $.FooGetJSON = function (url, data, success, error) { 
    /// <summary> 
    /// ********************************************************** 
    /// * UNIK GET JSON JQUERY PLUGIN.       * 
    /// ********************************************************** 
    /// This plugin is a wrapper for jQuery.getJSON. 
    /// The reason is that jQuery.getJSON success handler doesn't provides access to the JSON object returned from the url 
    /// when a HTTP status code different from 200 is encountered. However, please note that whether there is JSON 
    /// data or not depends on the requested service. if there is no JSON data (i.e. response.responseText cannot be 
    /// parsed as JSON) then the data parameter will be undefined. 
    /// 
    /// This plugin solves this problem by providing a new error handler signature which includes a data parameter. 
    /// Usage of the plugin is much equal to using the jQuery.getJSON method. Handlers can be added etc. However, 
    /// the only way to obtain an error handler with the signature specified below with a JSON data parameter is 
    /// to call the plugin with the error handler parameter directly specified in the call to the plugin. 
    /// 
    /// success: function(data, textStatus, jqXHR) 
    /// error: function(data, jqXHR, textStatus, errorThrown) 
    /// 
    /// Example usage: 
    /// 
    /// $.FooGetJSON('/foo', { id: 42 }, function(data) { alert('Name :' + data.name); }, function(data) { alert('Error: ' + data.message); }); 
    /// </summary> 

    // Call the ordinary jQuery method 
    var jqxhr = $.getJSON(url, data, success); 

    // Do the error handler wrapping stuff to provide an error handler with a JSON object - if the response contains JSON object data 
    if (typeof error !== "undefined") { 
     jqxhr.error(function(response, textStatus, errorThrown) { 
     try { 
      var json = $.parseJSON(response.responseText); 
      error(json, response, textStatus, errorThrown); 
     } catch(e) { 
      error(undefined, response, textStatus, errorThrown); 
     } 
     }); 
    } 

    // Return the jQueryXmlHttpResponse object 
    return jqxhr; 
    }; 
})(jQuery); 

मैं इन सब से क्या प्राप्त करूं? अंतिम परिणाम यह है कि

  • मेरे नियंत्रक कार्यों में से कोई भी हैंडलरर एट्रिब्यूट्स पर आवश्यकताएं नहीं हैं।
  • मेरे नियंत्रक कार्यों में से कोई भी दोहराव वाले बॉयलर प्लेट त्रुटि कोड को संभालने में शामिल नहीं है।
  • मेरे पास त्रुटि हैंडलिंग कोड का एक बिंदु है जो मुझे आसानी से लॉगिंग और अन्य त्रुटियों से संबंधित सामग्री को संभालने की अनुमति देता है।
  • एक साधारण आवश्यकता: JsonResult के लौटने वाले नियंत्रक कार्यों में वापसी का प्रकार JsonResult होना चाहिए और कुछ मूल प्रकार जैसे ActionResult नहीं होना चाहिए। कारण: FooHandleErrorAttribute में कोड टिप्पणी देखें।

क्लाइंट साइड उदाहरण:

var success = function(data) { 
    alert(data.myjsonobject.foo); 
}; 
var onError = function(data) { 
    var message = "Error"; 
    if(typeof data !== "undefined") 
    message += ": " + data.message; 
    alert(message); 
}; 
$.FooGetJSON(url, params, onSuccess, onError); 

टिप्पणियाँ बहुत स्वागत है! मैं शायद कुछ दिन इस समाधान के बारे में ब्लॉग होगा ...

+0

boooo! एक विशिष्ट स्थिति को संतुष्ट करने के लिए एक विशाल उत्तर की तुलना में केवल एक आवश्यक स्पष्टीकरण के साथ एक सरल जवाब होना बेहतर है। अगली बार एक सामान्य उत्तर के लिए जाओ, तो हर कोई इसका उपयोग कर सकते हैं – pythonian29033

0

सर्वर/प्रोटोकॉल त्रुटियों के लिए मैं बाकी/HTTP संभव के रूप में (आप अपने ब्राउज़र में यूआरएल में टाइप के साथ इसकी तुलना) के रूप में होने की कोशिश करेंगे:

  • एक गैर मौजूदा आइटम (/ व्यक्तियों/{गैर-मौजूदा-आईडी-यहां} कहा जाता है) कहा जाता है। 404 पर लौटें।
  • सर्वर (कोड बग) पर एक अनपेक्षित त्रुटि हुई। 500 लौटें।
  • ग्राहक उपयोगकर्ता संसाधन प्राप्त करने के लिए अधिकृत नहीं है। लौटें एक 401.

डोमेन/व्यापार तर्क विशिष्ट त्रुटियों के लिए मैं कहूंगा कि प्रोटोकॉल सही तरीके से प्रयोग किया जाता है और वहाँ कोई सर्वर आंतरिक त्रुटि है, तो एक त्रुटि JSON/XML वस्तु या जो भी आप का वर्णन करने के लिए पसंद के साथ प्रतिक्रिया के साथ अपने डेटा (यदि आप एक वेबसाइट पर फ़ॉर्म भरने के साथ इसकी तुलना):

  • एक उपयोगकर्ता अपने खाते का नाम बदलना चाहता है, लेकिन उपयोगकर्ता ने अभी तक कोई ई-मेल में एक लिंक है जो करने के लिए भेजा गया था पर क्लिक करके अपने खाते को सत्यापित नहीं किया उपभोक्ता। वापसी {"त्रुटि": "खाता सत्यापित नहीं है"} या जो भी हो।
  • कोई उपयोगकर्ता एक पुस्तक आदेश देना चाहता है, लेकिन पुस्तक बेची गई थी (डीबी में राज्य बदल गया) और अब आदेश नहीं दिया जा सकता है। वापसी {"त्रुटि": "पुस्तक पहले ही बेची गई"}।
0

हां, आपको HTTP स्थिति कोड का उपयोग करना चाहिए।और यह भी अधिमानतः कुछ हद तक एक मानकीकृत JSON प्रारूप में त्रुटि विवरणों को लौटने के लिए, Nottingham’s proposal की तरह, apigility Error Reporting देखें:

The payload of an API Problem has the following structure:

  • type: a URL to a document describing the error condition (optional, and "about:blank" is assumed if none is provided; should resolve to a human-readable document; Apigility always provides this).
  • title: a brief title for the error condition (required; and should be the same for every problem of the same type; Apigility always provides this).
  • status: the HTTP status code for the current request (optional; Apigility always provides this).
  • detail: error details specific to this request (optional; Apigility requires it for each problem).
  • instance: URI identifying the specific instance of this problem (optional; Apigility currently does not provide this).