|
|
|
|
|
|
by __experiment__
785 days ago
|
|
|
I need input on this new API design, i call if 'Functional APIs(fAPIs)' Given that hacker news is mostly developer-oriented i would like your opinion as to why we don't use "HTTP APIs" as mostly single functions instead of the REST and GraphQL horrors i see on a weekly basis. why not: https://example.org/api_json_create_new_user body -> {
'name': 'new user'
'email': 'email@gmail.com'
'password_hash': '50e721e49c013f00c62cf59f2163542a9d8df02464efeb615d31051b0fddc326'
...
} 200 OK instead of https://example.org/v1/users/create/new
<body> 200 OK i attached a PDF link with more details. criticism is welcomed. |
|
|
You start off with a ‘complex’ JSON but there’s absolutely nothing in the PDF that describes how this fApi is meant to address that.
Also not seeing any real justification as to the actual real need for this, other than “it’s different”.
Finally the claim that the versioning is somehow better, to me is the exact opposite. By having the version number at the start it makes it easy to switch between versions without having to append to a “function name”.
Sorry, but it’s an absolute hard-pass from me. As it stands I fail to see any value whatsoever in this over RestAPI.
Dog knows I’m no fan of GraphQL, but I’d take that over this any day of the week and twice on a Wednesday…