Can a link in a hal/json element return a 404? -


im implementing hal/json api.

the root object (soldier) has related object (sword), mapped under /soldier/{object_id}/sword

{   "id": 12345,   "name": "sir smokealot",   "_links": {     "self": {       "href": "http://soldier.local:8080/soldier/12345"     },     "sword": {       "href": "http://soldier.local:8080/soldier/12345/sword"     }   } }

but not every soldier has sword. imagine poor soldier without sword.

  1. if retrieve soldier-object, should link /soldier/{object_id}/sword appear in _links-array?

  2. and if should, link? empty object or 404? allowed hal/json rfc have links in _links-array lead 404?

i don't ask how solve this, want know whats right.

ideally, think wouldn't publish link if soldier doesn't have sword (if it's not expensive calculate). returning httpstatuscode 404 leaves no room interpretation in opinion, unlike "empty object" (whatever be). don't see issues link leading 404, proposed draft specification might interpreted otherwise (rfc 5988 seems have info on this).

i don't think you'll find strict, enforced rules in area of restful hal, more guidelines, there's right or wrong, black or white, more shades of grey - find out works , establish clear contract clients.


Comments

Post a Comment

Popular posts from this blog

asynchronous - C# WinSCP .NET assembly: How to upload multiple files asynchronously -

i using winscp .net assembly uploading files. want upload multiple files asynchronous way. have created method works single upload. public class uploadingdata { private sessionoptions _sessionoptions; private session _session; //connection etc private void onconnected() { foreach (var fileinfo in localfileslist) { var task = task.factory.startnew(() => uploadfilesasync(fileinfo)); } } private async task uploadfilesasync(string file) { string remotefilepath = _session.translatelocalpathtoremote(file, @"/", "/test_data_upload"); var uploading = _session.putfiles(file, remotefilepath, false); //when done await task.run(() => thread.sleep(1000)); } } please suggest me correct way. thanks you can use backgroundworker class this: string[] images = new string[50]; foreach (var path in images) { backgroundworker
Read more

aws api gateway - SerializationException in posting new Records via Dynamodb Proxy Service in API -

i getting "__type": "com.amazon.coral.service#serializationexception" as reply in postman & in test console in api gateway trying post record directly dynamodb using api proxy services.. referring aws article - https://aws.amazon.com/blogs/compute/using-amazon-api-gateway-as-a-proxy-for-dynamodb/ here's mapping { "tablename": "tablenamegoeshere", "item": { "id" : "$context.requestid" "eventname" : "$input.path('$.eventname')", "timestamp" : $input.path('$.timestamp'), "answers": "$util.parsejson($input.path('$.answers'))" } } update: did asked ... , worked if try add array of json objects gives me above same error - here's trying now. please - couldnt find on google well #set($inputroot = $input.path('$')) { "tablename": "answer", "item": {
Read more

asp.net - Problems sending emails from forum -

i have been redesigning site has message board, has been written guy looked after site. it has few problems , written in .asp , uses .mdb files database. you can see whole thing here . feel free post if helps, test thing have set using original files , new database. the basic problem when posts message, supposed email sent them, have posted it. when replies, originator supposed message, replier has been posted. i’d have thought @ point in process there should script/file in postmessage.asp? the postmessage.asp page below. <% option explicit %> <!-- #include virtual="common/adovbs.inc" --> <html> <head> <meta http-equiv="content-type" content="text/html; charset=windows-1252"> <meta name="generator" content="microsoft frontpage 4.0"> <meta name="progid" content="frontpage.editor.document"> <title>new page 2</title> <base target="_self"
Read more