TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

Show HN: Datoji – FREE HTTP JSON storage service

12 pointsby daviducoloalmost 5 years ago

1 comment

jones1618almost 5 years ago
It looks like an interesting and useful project but the API is strange and the documentation confusing at best (compared to other JSON stores I&#x27;ve used).<p>* Why &quot;packs&quot; and &quot;items&quot; when there are so many more common terms? &quot;Containers&quot; and &quot;Objects&quot; or &quot;Tables&quot; and &quot;Records&quot; or &quot;Collections&quot; and &quot;Documents&quot;. At the very least you could&#x27;ve explained the correspondence to familiar terms.<p>* Your documentation makes no distinction between &quot;system&quot; fields&#x2F;attributes and &quot;application&quot; fields&#x2F;attributes. Users of the API want to see and use THEIR data, not your APIs data. It would be clearer if system attributes had a prefix, maybe just an underscore or &quot;dj_&quot;.<p>* The above is made worse because your objects contain so many system attributes and unnecessary nested structures.<p>* Your documentation for &quot;clear&quot; and &quot;delete&quot; is the same? What&#x27;s the difference?<p>* You never describe &quot;relationships&quot;, whether they are created for or by the user, or what they are good for. Likewise, what&#x27;s the &quot;type&quot; attribute for if everything is the same type?<p>* Why, oh why, do you need a data collection inside an attribute collection? If you include metadata (like timestamps) why not just include them as attributes, maybe distinguished by names like _created_at or dj_created_at?<p>* You mention query&#x2F;ordering syntax but then don&#x27;t show clear examples of it