Skip to content
  • Categories
  • Recent
  • Tags
  • Popular
  • World
  • Users
  • Groups
Skins
  • Light
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • Dark
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • Default (No Skin)
  • No Skin
Collapse
We Distribute
  1. Home
  2. General Discussion
  3. I think the #ActivityPub client-to-server API is extremely important and underrated.

I think the #ActivityPub client-to-server API is extremely important and underrated.

Scheduled Pinned Locked Moved General Discussion
activitypubfediverse
115 Posts 13 Posters 0 Views
  • Oldest to Newest
  • Newest to Oldest
  • Most Votes
Reply
  • Reply as topic
Log in to reply
This topic has been deleted. Only users with topic management privileges can see it.
  • evan@cosocial.caE evan@cosocial.ca

    @smallcircles @steve it's ok if you haven't heard of a REST API. It's an API that uses HTTP for reading and writing data. Wikipedia has a good
    article about it:

    Link Preview Image
    REST - Wikipedia

    favicon

    (en.wikipedia.org)

    evan@cosocial.caE This user is from outside of this forum
    evan@cosocial.caE This user is from outside of this forum
    evan@cosocial.ca
    wrote last edited by
    #97

    @smallcircles @steve one anti-pattern I dislike seeing in ActivityPub discussions is that only one interaction defined in the ActivityPub spec is valid: an HTTP POST to an actor's `inbox` for server-to-server interactions.

    We can use HTTP GET to fetch additional data about objects, actors and collections.

    evan@cosocial.caE 1 Reply Last reply
    0
    • evan@cosocial.caE evan@cosocial.ca

      @smallcircles @steve one anti-pattern I dislike seeing in ActivityPub discussions is that only one interaction defined in the ActivityPub spec is valid: an HTTP POST to an actor's `inbox` for server-to-server interactions.

      We can use HTTP GET to fetch additional data about objects, actors and collections.

      evan@cosocial.caE This user is from outside of this forum
      evan@cosocial.caE This user is from outside of this forum
      evan@cosocial.ca
      wrote last edited by
      #98

      @smallcircles @steve So, I disagree that we have to exclusively adopt a message-passing paradigm for ActivityPub.

      EDIT: note that it's exclusive.

      cwebber@social.coopC 1 Reply Last reply
      0
      • evan@cosocial.caE evan@cosocial.ca

        @smallcircles @steve So, I disagree that we have to exclusively adopt a message-passing paradigm for ActivityPub.

        EDIT: note that it's exclusive.

        cwebber@social.coopC This user is from outside of this forum
        cwebber@social.coopC This user is from outside of this forum
        cwebber@social.coop
        wrote last edited by
        #99

        @evan @smallcircles @steve ActivityPub already is a message passing paradigm

        smallcircles@social.coopS evan@cosocial.caE 2 Replies Last reply
        0
        • cwebber@social.coopC cwebber@social.coop

          @evan @smallcircles @steve ActivityPub already is a message passing paradigm

          smallcircles@social.coopS This user is from outside of this forum
          smallcircles@social.coopS This user is from outside of this forum
          smallcircles@social.coop
          wrote last edited by
          #100

          @evan

          > it's ok if you haven't heard of a REST API.

          Well, you be you. I consider this a 'typical Evan remark' by now, dripping with sarcasm. It is a weird fit for someone who want to lead the #SocialCG efforts, I'd say.

          Ah well. What I am talking about is architecture and design, and all the things that allow people to easily form a clear mental picture on how things fit together, wrap their head around the fediverse.

          A HTTP interface is a very low-level thing, and clearly but one of the many moving parts that play a role in #ActivityPub based solution development.

          Never defining this well, and having the documentation be scattered all across the fediverse in 1,001 random locations doesn't help. Meanwhile the dev talk that is going on for years remains very inefficient due to endless Babylonian speech confusion.

          🫧 socialcoding.. (@smallcircles@social.coop)

          #ThoughtProvoker :blobhyperthink: The current fediverse is an evolutionary dead-end for 2 reasons: 1. It has painted itself in a small niche of decentralizing typical social media use cases, by means of post-facto interop and the introduction of protocol decay. 2. Lacking a proper grassroots standardization process, and with the primary mechanism for fediverse extension being only post-facto interoperability, there is no way out. Congratulations to the early adopters, who managed to "cross the chasm" with their own app platforms. It took true grit to become deep #ActivityPub experts, and plug holes needed for your app, but you have made it. Post-facto interop works in your favor now. You are unrestrained to productively add more features in your app, and put them on the fedi wire for others to deal with. To avoid fedi to become less and less attractive to newcomers, we must now consider: “Why do we want to grow the open social web, and for whom?” -- @ben@werd.social http://coding.social/blog/shared-ownership/

          favicon

          social.coop (social.coop)

          @cwebber @steve

          evan@cosocial.caE 1 Reply Last reply
          0
          • smallcircles@social.coopS smallcircles@social.coop

            @evan

            > it's ok if you haven't heard of a REST API.

            Well, you be you. I consider this a 'typical Evan remark' by now, dripping with sarcasm. It is a weird fit for someone who want to lead the #SocialCG efforts, I'd say.

            Ah well. What I am talking about is architecture and design, and all the things that allow people to easily form a clear mental picture on how things fit together, wrap their head around the fediverse.

            A HTTP interface is a very low-level thing, and clearly but one of the many moving parts that play a role in #ActivityPub based solution development.

            Never defining this well, and having the documentation be scattered all across the fediverse in 1,001 random locations doesn't help. Meanwhile the dev talk that is going on for years remains very inefficient due to endless Babylonian speech confusion.

            🫧 socialcoding.. (@smallcircles@social.coop)

            #ThoughtProvoker :blobhyperthink: The current fediverse is an evolutionary dead-end for 2 reasons: 1. It has painted itself in a small niche of decentralizing typical social media use cases, by means of post-facto interop and the introduction of protocol decay. 2. Lacking a proper grassroots standardization process, and with the primary mechanism for fediverse extension being only post-facto interoperability, there is no way out. Congratulations to the early adopters, who managed to "cross the chasm" with their own app platforms. It took true grit to become deep #ActivityPub experts, and plug holes needed for your app, but you have made it. Post-facto interop works in your favor now. You are unrestrained to productively add more features in your app, and put them on the fedi wire for others to deal with. To avoid fedi to become less and less attractive to newcomers, we must now consider: “Why do we want to grow the open social web, and for whom?” -- @ben@werd.social http://coding.social/blog/shared-ownership/

            favicon

            social.coop (social.coop)

            @cwebber @steve

            evan@cosocial.caE This user is from outside of this forum
            evan@cosocial.caE This user is from outside of this forum
            evan@cosocial.ca
            wrote last edited by
            #101

            @smallcircles @cwebber @steve hey, Arnold.

            I don't think argument from ignorance is a good way to have a discussion.

            I chose to take you at your word that you didn't know what a "read-write API" is, and that you couldn't figure it out from context clues, so I dropped a link to Wikipedia.

            What would you have done, if you were me?

            smallcircles@social.coopS 1 Reply Last reply
            0
            • cwebber@social.coopC cwebber@social.coop

              @evan @smallcircles @steve ActivityPub already is a message passing paradigm

              evan@cosocial.caE This user is from outside of this forum
              evan@cosocial.caE This user is from outside of this forum
              evan@cosocial.ca
              wrote last edited by
              #102

              @cwebber @smallcircles @steve thanks for that important clarification.

              It does use message-passing, but not exclusively. I'll update my reply.

              smallcircles@social.coopS 1 Reply Last reply
              0
              • evan@cosocial.caE evan@cosocial.ca

                @cwebber @smallcircles @steve thanks for that important clarification.

                It does use message-passing, but not exclusively. I'll update my reply.

                smallcircles@social.coopS This user is from outside of this forum
                smallcircles@social.coopS This user is from outside of this forum
                smallcircles@social.coop
                wrote last edited by
                #103

                @evan @cwebber @steve

                Which was exactly what I also indicated above, and which aligns to that diagram as well.

                evan@cosocial.caE 1 Reply Last reply
                0
                • evan@cosocial.caE evan@cosocial.ca

                  @smallcircles @cwebber @steve hey, Arnold.

                  I don't think argument from ignorance is a good way to have a discussion.

                  I chose to take you at your word that you didn't know what a "read-write API" is, and that you couldn't figure it out from context clues, so I dropped a link to Wikipedia.

                  What would you have done, if you were me?

                  smallcircles@social.coopS This user is from outside of this forum
                  smallcircles@social.coopS This user is from outside of this forum
                  smallcircles@social.coop
                  wrote last edited by
                  #104

                  @evan @cwebber @steve

                  So why don't you use the word REST? I never encountered "read-write API". It is an informal term.

                  But that is not the point. You can have a REST API, fine. But that says nothing in itself. What does it expose? You might say "Duh.. ActivityPub!" but that is not very informative either. There is the notion of message exchange, and of an addressing mechanism, indicating higher level abstractions that conform to well-known architecture patterns, and would allow us to have more productive communication, delve less in implementation details and confusions of protocol behavior with solution design functionality, for starters.

                  evan@cosocial.caE 1 Reply Last reply
                  0
                  • smallcircles@social.coopS smallcircles@social.coop

                    @evan @cwebber @steve

                    Which was exactly what I also indicated above, and which aligns to that diagram as well.

                    evan@cosocial.caE This user is from outside of this forum
                    evan@cosocial.caE This user is from outside of this forum
                    evan@cosocial.ca
                    wrote last edited by
                    #105

                    @smallcircles @cwebber @steve awesome.

                    So, would you like me to review your diagram and give comments? I don't know what you're looking for from me in this conversation.

                    smallcircles@social.coopS 1 Reply Last reply
                    0
                    • evan@cosocial.caE evan@cosocial.ca

                      @smallcircles @cwebber @steve awesome.

                      So, would you like me to review your diagram and give comments? I don't know what you're looking for from me in this conversation.

                      smallcircles@social.coopS This user is from outside of this forum
                      smallcircles@social.coopS This user is from outside of this forum
                      smallcircles@social.coop
                      wrote last edited by
                      #106

                      @evan @cwebber @steve

                      Not needed. I hope to be able to add some feedback to the AP API repo.

                      evan@cosocial.caE 1 Reply Last reply
                      0
                      • smallcircles@social.coopS smallcircles@social.coop

                        @evan @cwebber @steve

                        Not needed. I hope to be able to add some feedback to the AP API repo.

                        evan@cosocial.caE This user is from outside of this forum
                        evan@cosocial.caE This user is from outside of this forum
                        evan@cosocial.ca
                        wrote last edited by
                        #107

                        @smallcircles @cwebber @steve I would personally really appreciate that. I also think it'd be helpful for the ecosystem. I like that you combine a high-level social and technical approach to discussions of ActivityPub and the Social Web with an almost encyclopedic knowledge of the details. It's a rare combination and extremely valuable.

                        smallcircles@social.coopS 1 Reply Last reply
                        0
                        • evan@cosocial.caE evan@cosocial.ca

                          @smallcircles @cwebber @steve I would personally really appreciate that. I also think it'd be helpful for the ecosystem. I like that you combine a high-level social and technical approach to discussions of ActivityPub and the Social Web with an almost encyclopedic knowledge of the details. It's a rare combination and extremely valuable.

                          smallcircles@social.coopS This user is from outside of this forum
                          smallcircles@social.coopS This user is from outside of this forum
                          smallcircles@social.coop
                          wrote last edited by
                          #108

                          @evan @cwebber @steve

                          Thank you, that is nice to hear. I am however not an expert, am but a humble generalist and a person who'd love to be in that Solution developer stakeholder role. Who however does not see the fediverse trend in a direction where I'd adopt the technology for what I have in mind. Drifting away from "the promise" that I read in the #ActivityPub specs in 2017, and which at the time made me decide to lend a helping hand here and there as #SocialHub facilitator and tech advocate.

                          evan@cosocial.caE 1 Reply Last reply
                          0
                          • smallcircles@social.coopS smallcircles@social.coop

                            @evan @cwebber @steve

                            Thank you, that is nice to hear. I am however not an expert, am but a humble generalist and a person who'd love to be in that Solution developer stakeholder role. Who however does not see the fediverse trend in a direction where I'd adopt the technology for what I have in mind. Drifting away from "the promise" that I read in the #ActivityPub specs in 2017, and which at the time made me decide to lend a helping hand here and there as #SocialHub facilitator and tech advocate.

                            evan@cosocial.caE This user is from outside of this forum
                            evan@cosocial.caE This user is from outside of this forum
                            evan@cosocial.ca
                            wrote last edited by
                            #109

                            @smallcircles what do you have in mind, and how is the Fediverse trending in the wrong direction for it?

                            smallcircles@social.coopS 1 Reply Last reply
                            0
                            • smallcircles@social.coopS smallcircles@social.coop

                              @evan @cwebber @steve

                              So why don't you use the word REST? I never encountered "read-write API". It is an informal term.

                              But that is not the point. You can have a REST API, fine. But that says nothing in itself. What does it expose? You might say "Duh.. ActivityPub!" but that is not very informative either. There is the notion of message exchange, and of an addressing mechanism, indicating higher level abstractions that conform to well-known architecture patterns, and would allow us to have more productive communication, delve less in implementation details and confusions of protocol behavior with solution design functionality, for starters.

                              evan@cosocial.caE This user is from outside of this forum
                              evan@cosocial.caE This user is from outside of this forum
                              evan@cosocial.ca
                              wrote last edited by
                              #110

                              @smallcircles @cwebber @steve I'm fine with that.

                              However, I think ActivityPub builds up persistent state on the server side which can be read and used by other processors.

                              For example, when I `Like` something, it goes into my `liked` collection, and the activity goes into the `likes` for that object. The `Like` activity goes into my `outbox` and others' `inbox`. People can review that information and use it.

                              evan@cosocial.caE 1 Reply Last reply
                              0
                              • evan@cosocial.caE evan@cosocial.ca

                                @smallcircles @cwebber @steve I'm fine with that.

                                However, I think ActivityPub builds up persistent state on the server side which can be read and used by other processors.

                                For example, when I `Like` something, it goes into my `liked` collection, and the activity goes into the `likes` for that object. The `Like` activity goes into my `outbox` and others' `inbox`. People can review that information and use it.

                                evan@cosocial.caE This user is from outside of this forum
                                evan@cosocial.caE This user is from outside of this forum
                                evan@cosocial.ca
                                wrote last edited by
                                #111

                                @smallcircles @cwebber @steve

                                Some implementations skip some of these steps, because they are focused only on processing messages as they arrive. So, I am reluctant to overemphasize the message processing at the expense of the personal datastore functionality.

                                1 Reply Last reply
                                0
                                • evan@cosocial.caE evan@cosocial.ca

                                  @smallcircles what do you have in mind, and how is the Fediverse trending in the wrong direction for it?

                                  smallcircles@social.coopS This user is from outside of this forum
                                  smallcircles@social.coopS This user is from outside of this forum
                                  smallcircles@social.coop
                                  wrote last edited by
                                  #112

                                  @evan

                                  So the area where my plans go I call "Residential social networking", geo-fenced but inter-connected social networking circles that cover a city, town, or rural area, and which enable their residents to not only create content on the network, but the dynamic apps and services based on local needs that exist in the area. The intent of a residential social network is to engage people *offline* and in activities that support the local economy. Or rather strengthens the Circles of Sustainability in SX terminology:

                                  Link Preview Image
                                  How We Reimagine the Social Web

                                  We find novel ways to collaborate and create value together.

                                  favicon

                                  Social coding commons (coding.social)

                                  And all this should be a relatively low-code affair, directly accessible already for a first-time dev. This requires having a mature open standards based healthy technology foundation and thriving ecosystem.

                                  I am a developer, though with rusty coding skills these days, and I might have started a fedi app design in 2018 or so. But this would not have led to the desired outcome, just throw one more app-centric software in the mix.

                                  evan@cosocial.caE 1 Reply Last reply
                                  0
                                  • smallcircles@social.coopS smallcircles@social.coop

                                    @evan

                                    So the area where my plans go I call "Residential social networking", geo-fenced but inter-connected social networking circles that cover a city, town, or rural area, and which enable their residents to not only create content on the network, but the dynamic apps and services based on local needs that exist in the area. The intent of a residential social network is to engage people *offline* and in activities that support the local economy. Or rather strengthens the Circles of Sustainability in SX terminology:

                                    Link Preview Image
                                    How We Reimagine the Social Web

                                    We find novel ways to collaborate and create value together.

                                    favicon

                                    Social coding commons (coding.social)

                                    And all this should be a relatively low-code affair, directly accessible already for a first-time dev. This requires having a mature open standards based healthy technology foundation and thriving ecosystem.

                                    I am a developer, though with rusty coding skills these days, and I might have started a fedi app design in 2018 or so. But this would not have led to the desired outcome, just throw one more app-centric software in the mix.

                                    evan@cosocial.caE This user is from outside of this forum
                                    evan@cosocial.caE This user is from outside of this forum
                                    evan@cosocial.ca
                                    wrote last edited by
                                    #113

                                    @smallcircles that sounds cool!

                                    kim@social.gfsc.studioK 1 Reply Last reply
                                    0
                                    • evan@cosocial.caE evan@cosocial.ca

                                      @smallcircles that sounds cool!

                                      kim@social.gfsc.studioK This user is from outside of this forum
                                      kim@social.gfsc.studioK This user is from outside of this forum
                                      kim@social.gfsc.studio
                                      wrote last edited by
                                      #114

                                      @evan @smallcircles just to note this is the ballpark i've been working in for a little while now

                                      Link Preview Image
                                      What's happening where you live? Re-introducing PlaceCal

                                      What is PlaceCal, why does it matter, how can you and your community benefit? Kim outlines our ambitions for community technology in 2026.

                                      favicon

                                      Geeks for Social Change (gfsc.community)

                                      1 Reply Last reply
                                      0
                                      • evan@cosocial.caE evan@cosocial.ca

                                        @deadsuperhero so, here's my best bet. I can be wrong!

                                        1. Get some servers to implement the API well.
                                        2. Get some must-have clients that run on those servers. This shows the value of the API.
                                        3. Our leading servers shift to supporting it.

                                        That may work; I don't know. It's my best bet right now!

                                        I want to note that WordPress is working on the API!

                                        countablenewt@mastodon.socialC This user is from outside of this forum
                                        countablenewt@mastodon.socialC This user is from outside of this forum
                                        countablenewt@mastodon.social
                                        wrote last edited by
                                        #115

                                        @evan @deadsuperhero

                                        Definitely interested in a universal client-server API for my own app

                                        That was a partial hurdle to originally creating it until I decided to bite the bullet and build on the Mastodon API for now (since that's where my Social Web account lives)

                                        1 Reply Last reply
                                        0
                                        Reply
                                        • Reply as topic
                                        Log in to reply
                                        • Oldest to Newest
                                        • Newest to Oldest
                                        • Most Votes


                                        • Login

                                        • Don't have an account? Register

                                        • Login or register to search.
                                        Powered by NodeBB Contributors
                                        • First post
                                          Last post
                                        0
                                        • Categories
                                        • Recent
                                        • Tags
                                        • Popular
                                        • World
                                        • Users
                                        • Groups