rest - Localizing reason phrase in status line of the RESTful HTTP API reponse -

-

we have restful api exposed on http in natural way makes use of http status-line (status-code , reason-phrase) communicate api result client (http://www.w3.org/protocols/rfc2616/rfc2616-sec6.html).

for example have following status line concurrency error:

http/1.1 409 resource updated different user. reload , try again.

it turned out messages presented end users of application built against our api meaning need localize them. i'm wondering if accepted approach in such scenarios, considering non-ascii charset of messages, or should reason phrase (status description) kept low level message , content make its' way user screen should passed in response body? there can bite later on if choose localize reason-phrase part?

in case use response body pass new version of resource api client , including additional data doesn't see play nicely that.

as you'll know rfc:

the status-code intended use automata , reason-phrase intended human user

so it's worth trying find balance between short , to-the-point while still being user-friendly. many webservices i've seen have status node (xml or json) containing code , more human-friendly message part of response data.

one potential issue: in 1 of our restful apis, customised reason phrase aid debugging. monitoring uptime pingdom, incorrectly accepted service being available if status matched suggested in rfc - (ie 200 ok). having pointed out them incorrect, referred rfc(!), although conceded had misinterpreted it.


Comments

Post a Comment

Popular posts from this blog

c# - How to set Z index when using WPF DrawingContext? -

-
how set z-index drawing object when using drawingcontext.drawxxx() methods? the object drawn last have higher z index. can't change index of drawn objects. way draw in order. if using wpf (as placed tag), can use, example, canvas control. create shapes need like polyline obj = new polyline(); //... // ... set properties of obj and add them canvas uielementcollection: yourcanvasname.children.add(obj); //or yourcanvasname.children.insert(i, obj); first items of collection have higher z index. advantages in way: no need redraw on window changes, can anytime move objects , change order.
Read more

razor - Is this a bug in WebMatrix PageData? -

-
i think may have found bug in webmatrix's pagedata, not sure. concerns how pass data partial page calling page. in webmatrix documentation (tutorials, e.g. " 3 - creating consistent look ", , example code), pagedata recommended mechanism pass data between pages (e.g. content page layout page, or partial page). however have found not work other way, pass data partial page calling page. modifying or adding entries in pagedata in partial page, not seem calling page. cutting right down simplest possible example, in test page may have this: @{ pagedata["test"] = "initial entry"; } <p>before calling partial page, test value @pagedata["test"]</p> @renderpage("_testpartial.cshtml") <p>after returning calling page, test value @pagedata["test"]</p> and in _testpartial.cshtml page might have this: @{ pagedata["test"] = "modified entry"; } <p>in partial page...
Read more

visual c++ - Using relative values in array sorting ( asm ) -

-
i need sort through array , sort each individual row in array in ascending order. doesn't seem going (surprise!) keep getting hit 2 errors: a2101: cannot add 2 relocatable labels , a2026: constant expected here's sort, makes sense me, think i'm still trying implement high-lvl language techniqes assembly. there way around not being able use relative values? (the array 7 rows 9 columns, btw). mov cx, 7; cx = number of rows outer: ; outer loop walk through rows push cx mov cx, 9 mov row, cx ;rows middle: ; middle-loop walk through columns push cx sub cx, 1 ;cx = cx-1 mov column, cx ;columns inner: ;inner loop - compare , exchange column values cmp marray[row*9 + column], marray[row*9 + column+1] xchg marray[row*9 + column+1], marray[row*9 + column] ; compare , exchange values marray table inc column loop inner pop cx loop mid...
Read more