rest - What should a link extension relation type URI point to in a RESTful API? -


i've been designing api needs restful, , have managed define system uses exclusively http headers , query string parameters define meta data body of responses free actual resource data only.

however i'm thinking links hateoas, , due wanting keep in http headers or query string parameters i've decided on using http link header field.

this has brought question rel attribute i'm having trouble finding direct answer for.

my idea collections of resources 1 of links sent in response like: link: <https://api.domain.com/things/{id}>; rel="..."

this allow client use simple string expansion, defined in rfc6570, create correct resource uri each resource in collection without me having embed meta data each resource , without client needing know other uri template , resource id.

however, i'm not sure rel should here, or should point to.

in rfc5988, says extension relation type must uri and:

although uri can point resource contains definition of semantics of relation type, clients should not automatically access resource avoid overburdening server.

my question is, should definition in restful api?

by looks of make rel https://api.domain.com/media/thing, or that.

but should actual definition content be?

it looks technically anything, example plain text document short explanation.

is there restful standard these kinds of rel attributes , should point to?

any appreciated.

looking @ richardson's maturity model level 3, rel seems representing name of published link/relationship. in case might translate curie:thing-by-id (provided you're using curies suggested in proposed hal draft), example. idea client search link name (rel), without peering actual url.


Comments

Post a Comment

Popular posts from this blog

sql server - Cannot query correctly (MSSQL - PHP - JSON) -

i have little problem on project. , turns out query result returns nothing when value of first name or last name has 'ñ' in it. here's code config.php: <?php ini_set('mssql.charset', 'utf-8'); header('content-type: text/html; charset=utf-8'); $servername = "192.168.1.21"; /* ip add of db server */ $connection = array("database" => "db", "uid" => "?", "pwd" => "***"); $conn = sqlsrv_connect($servername, $connection); if(!$conn){ echo "connection not established."; die(print_r(sqlsrv_errors(), true)); } ?> myquery: $idnumber = $_post["idnum"]; $response = array(); $query2 = "select clname, cfname, cmname, cqualifier student cidno = '$idnumber'"; try{ $stmt2 = sqlsrv_query($conn, $query2); } catch(pdoexeption $ex){ $response["success"] = 0; $response["message"] = "d...
Read more

php - trouble displaying mysqli database results in correct order -

i have table in database stores events , date expire. want display events on website display current events first expired events after? i have tried following sql $sql = "select noticeid, notice, noticedesc, noticeimg, noticedate, expirydate tbl_notices group noticeid ,expired order expirydate asc"; but returns expired results first due expirydate being ordered asc in query. my tbl_notice structure looks this noticeid => int(4) notice => varchar(100) noticedesc => text noticedate => timestamp noticeimg => varchar(40) expirydate => datetime expired => int(1) 0 current or 1 expired my php code is $sql = "select noticeid, notice, noticedesc, noticeimg, noticedate, expirydate tbl_notices group noticeid ,expired order expirydate asc"; $result = mysqli_query($conn,$sql); if ($result->num_rows > 0) { // output data of each row while($row = $result->fetch_assoc()) { ...
Read more

C++ Linked List -

i trying create linked list download txt file , use linked list handle file line line. when handling downloaded linked list operations performed on such text editor would. encountering problems however. seems "node(string value)" section of code has wrong though original node() declaration no arguments passes. unable figure out quite is. node.h class node { public: node(); node(string value); void setnext(node *nextnode); // allows user set "next" pointer of node points friend class linkedlist; private: string data; // data box node* next; // pointer box }; node.cpp # include <string> # include "node.h" using namespace std; node::node() { data = ""; next = null; } node::node(string value) { data = value; next = null; } void node::setnext(node *nextnode) // allows user set "next" pointer of node points { this->next = nextnode; } your #include <string> ...
Read more