Arigion 156 points 3 years ago

Here's an article about it: https://dev.to/...

The thing that annoys me is the response. It should return status 201 created and the id of the new resource for future delete/update operations. Instead it returns 200 ok and some clear text. Wouldn't want to work with such an API.

save

path: 0 1844745, hotness: undefined, score: 156, children: 18

umbraroze 125 points 3 years ago

/serious Well, yes, most APIs are meant for system-to-system interaction, that's kind of a given. But since this particular API is clearly meant for human-to-system interaction, returning a human-readable response is adequate. Yes, a better design would probably allow the client to specify additional parameters about the desired response.

/back-to-jokes Yeah, well this kind of sums up most of my job applications. I send an application and the recruiting people are all like "OK".

save

path: 0 1844745 1844875, hotness: undefined, score: 125, children: 7

hstde 88 points 3 years ago

At least you do get a response.

save

path: 0 1844745 1844875 1845089, hotness: undefined, score: 88, children: 6

VanillaGorilla 29 points 3 years ago

That's hilarious. Probably the lovechild of some clueless HR dude that thought he was a genius.

save

path: 0 1844745 1844951, hotness: undefined, score: 29, children: 4

GigglyBobble 55 points 3 years ago

The cringe term "code ninja" supports your theory.

save

path: 0 1844745 1844951 1845328, hotness: undefined, score: 55, children: 2

saltesc 2 points 3 years ago

Hey, that's me! I query my workforce data from the HRIS with M and SQL. In HR land, that makes me a super senior data scientist compared to VLOOKUP guy who hasn't even heard of XLOOKUP or even INDEX/MATCH, that asshole.

save

path: 0 1844745 1844951 1868690, hotness: undefined, score: 2, children: 0

salient_one 4 points 3 years ago

Very RESTless.

save

path: 0 1844745 1855735, hotness: undefined, score: 4, children: 2

Carighan 1 point 3 years ago

A few things about that stuck out to me.

One interesting question to others here: Would you agree with the line under this comparison that the HTML response is self-describing?

Because frankly... I kinda don't. You need an interpreter to make sense of it, namely a web browser that knows the HTML-specification and can translate the HTML tags into meaningful semantics. But the moment I need that, I could also have a JSON interpreter in my system that uses a DSL we use internally to make sense of the JSON received, no? It's essentially the same thing.

save

path: 0 1844745 1855735 1963889, hotness: undefined, score: 1, children: 1

penguin 3 points 3 years ago

That's better than some I've seen. Like 200 for everything and the text could even be "error".

Or 500 with the text "invalid input"

save

path: 0 1844745 1851253, hotness: undefined, score: 3, children: 0

4am 0 points 3 years ago

I also notice that the job you apply for seems to be a different value than what is displayed on the page. Seems like the documentation needs updating as well 😔

save

path: 0 1844745 1851952, hotness: undefined, score: 0, children: 0

Rules:

Rules: