Since the docs are horrible I think making a megathread here with Q&As and best practices for endpoints would be nice. Would’ve certainly helped me when I started out.

What do you guys think?

  • blawsybogsy
    link
    fedilink
    arrow-up
    3
    ·
    1 year ago

    i’m building a client, happy to help if i can, also to receive help! main issues i have had so far is how to actually use a number of the methods’ parameters, like limit (whats the max value?), page (how does pagination actually work?), etc. so far i have been storing any useful info about the API (like the valid values for a given type) in my own lists then querying them in my code.

    • blawsybogsy
      link
      fedilink
      arrow-up
      1
      ·
      1 year ago

      but i figure the whole community is already about best practices the API / endpoints

      • Cr4yfish@lemmy.worldOP
        link
        fedilink
        arrow-up
        1
        ·
        1 year ago

        Yeah but I think having a central post to aggregate common questions would be a benefit to everyone, especially new devs.

    • Cr4yfish@lemmy.worldOP
      link
      fedilink
      arrow-up
      1
      ·
      1 year ago

      What’s the exact problem with the pagination? Basically you set the page param to the page you want to receive. The amount of pages is unknown to the client, you just know how many per Page you receive (the limit).

      However, I’d recommend to make infinite scrollers anyway.

      • blawsybogsy
        link
        fedilink
        arrow-up
        1
        ·
        1 year ago

        i’m just unsure how to actually correctly fetch the next set items in order to update display, whether for scrolling or paginating. for my client i just want to append at the bottom of the screen.

  • Drew Belloc@programming.dev
    link
    fedilink
    arrow-up
    2
    ·
    1 year ago

    Looks like a good idea, i wanna to build a desktop client but is easier to read the code of other apps then build using the docs

  • Prefix@lemm.eeM
    link
    fedilink
    arrow-up
    1
    ·
    1 year ago

    Hey there!

    I’m not opposed to a megathread per-se, but it does feel like we’d be doing more good by focusing that energy on improving the docs and keeping those as the central source of truth. PR’s are always open/welcome.

    Happy to revisit this if there is a strong demand for a megathread, but in general I don’t feel like we have enough content flowing through this community just yet to justify it.