Time |
S |
Nick |
Message |
03:28 |
|
|
Haudegen joined #rest |
06:37 |
|
jgl |
mamund: finally our approach has been to enable a new /metadata/schemas endpoint which we have whitelisted in our authorization server, the request still needs to be authenticated, but no further checks are needed for the whitelisted endpoints. And what this returns are all the whitelisted schemas types in the format 'key_path: type, for arrays we have encoded the path whith "0", for instance, if an schema has |
06:37 |
|
jgl |
this structure: {a:[{x: "string"}]} means that the "a" key can hold (0,n) objects that have a "x" key which values will be always strings. So the end point returns {"entiy_name": {"a.0.x" : "string"}} |
07:45 |
|
|
Haudegen joined #rest |
11:26 |
|
|
Haudegen joined #rest |
12:32 |
|
|
interop_madness joined #rest |
12:32 |
|
|
interop_madness joined #rest |
13:40 |
|
|
tbsf joined #rest |
13:42 |
|
|
tbsf joined #rest |
14:40 |
|
|
ResidentBiscuit joined #rest |
16:31 |
|
|
wsieroci joined #rest |
16:40 |
|
|
tbsf joined #rest |
16:40 |
|
|
tbsf joined #rest |
18:16 |
|
|
tbsf joined #rest |
19:36 |
|
|
Devastator joined #rest |
19:37 |
|
Devastator |
good evening, can someone recommend books about api design? also, can api design be discussed here? |
19:41 |
|
|
wsieroci joined #rest |
20:46 |
|
|
tbsf joined #rest |
20:57 |
|
|
tbsf joined #rest |
22:38 |
|
|
talios joined #rest |
23:16 |
|
whartung |
mamund should have some book ideas Devastator |
23:16 |
|
Devastator |
whartung thank you |
23:17 |
|
Devastator |
whartung do you know if it is ok to ask about api design here? |
23:17 |
|
whartung |
sure |
23:17 |
|
whartung |
REST is pretty much all about API. |
23:17 |
|
whartung |
it’s an architecture |
23:17 |
|
whartung |
so its all about design |
23:18 |
|
Devastator |
whartung I was presented with this "book", but it seems the opposite of what I've learned so far: http://restcookbook.com/Basics/hateoas/ |
23:23 |
|
whartung |
how so? |
23:26 |
|
Devastator |
whartung for example the discussion about using plural or singular just below the text |
23:26 |
|
Devastator |
does it matter? |
23:49 |
|
whartung |
well, first off, philisophically, “urls don’t matter”. Because, well, they don’t. They’re solely for human consumption, the computer doesn’t care. so its a matter of taste… bike shed argument |
23:50 |
|
whartung |
like what Harry McIntyre says |
23:52 |
|
Devastator |
whartung thanks, may I give you a real example of what I'm thinking for my api? |
23:52 |
|
whartung |
of course |
23:57 |
|
Devastator |
whartung it will be an ERP, so I'm thinking on dividing each module as a context, for example: /commercial/quote/ |
23:57 |
|
Devastator |
does this look sane? |
23:58 |
|
whartung |
I look at it this way. If you are focusing on URL structure, and not hypermedia formats and representation, you’re doing it the wrong way. in rest, the hypermedia is what matters, not the URLs. |