search

rchain-community / rchain-bounties-api

API for the RChain bounties network
https://api.rchain.cloud
0 stars 0 forks source link

motivation? #1

Open dckc opened 6 years ago

dckc commented 6 years ago

The README says:

A new general API for the RChain bounties platform. This allows anyone to create an interface for the RChain bounties platform.

In what way is the current rewards.rchain.coop not a general API that lets anyone create an interface?

cf. https://indieweb.org/API

tschoffelen commented 6 years ago

Technically speaking you could indeed argue that what's there currently is an API, but it is not in any way generalised.

I believe the goal of this effort is a developing a REST API that implements the JSONAPI spec, which should make quickly requesting data out of the rewards.rchain.coop database a lot easier.

dckc commented 6 years ago

... but it is not in any way generalised.

You say that like it's a bad thing. :)

Generality is often a cost without benefit. http://wiki.c2.com/?YouArentGonnaNeedIt

Taking a quick look at the http://jsonapi.org/format/ spec... oh no...

The members data and errors MUST NOT coexist in the same document.

Have they not heard of sum types?

Anyway... my question remains: what's the motivation? Why is implementing the JSONAPI spec a useful goal?

Hint: tell me a story. https://informatics.gpcnetwork.org/trac/Project/wiki/StoryTellingAndTestCases