I would like to be able to use the command line (curl) to get a list of communities I am currently subscribed to.

I know that there is a full-blown API, but it only briefly covers what it is possible with simple a curl request, and most of it seems to refer to an API that runs in javascript (which seems excessively complex for what I want to do?)

A simple curl request like this seems to work,

curl "https://mander.xyz/api/v3/community/list" | jq

But I wouldn’t know how to make it list only communities that I subscribe to? Does anyone know more?

  • nachtigall@feddit.deEnglish
    0·
    1 year ago

    For subscribed communities you have to add an auth parameter (that you can obtain by POST’ing {"username_or_email": "your_name", "password": "your_password"} to /user/login, then extracting the jwt from the response) and type_=Subscribed. A complete request would look like that:

    curl "https://mander.xyz/api/v3/community/list?auth=verylongstring&type_=Subscribed" | jq

    EDIT: added missing quotes for JSON keys, thanks to @NeonWoofGenesis@lemmy.henlo.fi

    • test_account@lemmy.mlEnglish
      1·
      1 year ago

      While this is the correct syntax, in reality the API is broken and isn’t returning communities (either filtered or sorted first) by their listingtype == “Subscribed”

    • notsofunnycomment@mander.xyzOPEnglish
      1·
      1 year ago

      This works! Thanks.

      If you’re up for it, one last question: just running curl "https://mander.xyz/api/v3/community/list?auth=longstring&type_=Subscribed gives me only a few subscribed communities.

      I can increase the number of subscribed communities that I get back, by adding &limit=.

      curl "https://mander.xyz/api/v3/community/list?auth=longstring&type_=Subscribed&limit=50"

      However, putting the limit too low I don’t get all my subscribed communities, while putting the limit too high results in an error.

      Is there a way to set limit to “max” or the limit to “nil” or something like that?

        • notsofunnycomment@mander.xyzOPEnglish
          2·
          1 year ago

          Ok, I’ll keep the monologue going: turns out I can loop through pages with that limit:

          curl "https://mander.xyz/api/v3/community/list?auth=longstring&type_=Subscribed&limit=50&page=1

          And then

          curl "https://mander.xyz/api/v3/community/list?auth=longstring&type_=Subscribed&limit=50&page=2

          Etc.