HackerTrans
TopNewTrendsCommentsPastAskShowJobs

__experiment__

no profile record

Submissions

Request for Comments: New API Design Concept [pdf]

origami.ink
2 points·by __experiment__·2 anni fa·3 comments

comments

__experiment__
·2 anni fa·discuss
I'm brave enough to remember LK99

does anyone know how this differ from outside temperature?
__experiment__
·2 anni fa·discuss
i have learned many language (german, english, french, japanese, korean).

i have used Anki, Supermemo, Flashcards, Watched Series, Read Books and the only thing that seems to work is:

- Spaced Repetition - Something you actually enjoy(learning should be fun) - Comprehensible Input

anything else has not worked for me.
__experiment__
·2 anni fa·discuss
you probably just lack time
__experiment__
·2 anni fa·discuss
remember that a lot of products sell convenience and time.

this is one of them
__experiment__
·2 anni fa·discuss
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 protected]' '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.
__experiment__
·2 anni fa·discuss
there are different people who value different things.

some value more control

some value more responsibility

some value more recognition
__experiment__
·2 anni fa·discuss
You have to understand that most APIs, most codebases, most designs, most documents, most ... everything

was done by people who did not receive the appropriated training in design patterns and has to glue something that worked in order to be proved by someone else

outside of a few orgs who chase excellency in every regard this is the reality for most companies, organizations and people. it makes sense given the circumstances they found themselves in.

it's actually quite impressive that anything works when you REALLY think about it

#