Nested structure

Overview

If you look into Raindrop UI you will notice a sidebar in left corner, where collections are located. Collections itself divided by groups. Groups useful to create separate sets of collections, for example "Home", "Work", etc.

Groups array is a single place where user root collection list and order is persisted. Why just not to save order position inside collection item itself? Because collections can be shared and they group and order can vary from user to user.

So to fully recreate sidebar like in our app you need to make 3 separate API calls (sorry, will be improved in future API updates):

1. Get user object​

It contains groups array with exact collection ID's. Typically this array looks like this:

{
  "groups": [
    {
      "title": "Home",
      "hidden": false,
      "sort": 0,
      "collections": [
        8364483,
        8364403,
        66
      ]
    },
    {
      "title": "Work",
      "hidden": false,
      "sort": 1,
      "collections": [
        8492393
      ]
    }
  ]
}

To get name, count, icon and other info about collections, make those two separate calls:

2. Get root collections​

Sort order of root collections persisted in groups[].collections array

3. Get child collections​

Sort order of child collections persisted in collection itself in sort field