On a fediverse server with a versioned client API, what would you expect to happen if an API call is made with a version number higher than what the server supports?
General Discussion
8
Posts
6
Posters
27
Views
-
On a fediverse server with a versioned client API, what would you expect to happen if an API call is made with a version number higher than what the server supports? Should it return an error? Should it take it to mean its highest supported version? Something else?
The API isn't RESTful, the version number is global for all methods (endpoints) and has the format "major.minor".
-
undefined julian@activitypub.space shared this topic on
-
On a fediverse server with a versioned client API, what would you expect to happen if an API call is made with a version number higher than what the server supports? Should it return an error? Should it take it to mean its highest supported version? Something else?
The API isn't RESTful, the version number is global for all methods (endpoints) and has the format "major.minor".
Hi @grishka,
using highest sounds like best effort and makes most sense to me. -
Hi @grishka,
using highest sounds like best effort and makes most sense to me.@mro but what if there are incompatible changes that the app doesn't expect? Like some object having a different format, or some method behaving differently
-
On a fediverse server with a versioned client API, what would you expect to happen if an API call is made with a version number higher than what the server supports? Should it return an error? Should it take it to mean its highest supported version? Something else?
The API isn't RESTful, the version number is global for all methods (endpoints) and has the format "major.minor".
@grishka Return an error that tells the client it's used an unsupported version.
By definition, the server does not know the semantics of the call the client made, so trying to guess and return something in the hope it's correct takes us out of the realm of engineering and into clairvoyance.
-
@grishka Return an error that tells the client it's used an unsupported version.
By definition, the server does not know the semantics of the call the client made, so trying to guess and return something in the hope it's correct takes us out of the realm of engineering and into clairvoyance.
nikclayton@mastodon.social agreed.
It's one thing for a server with a newer API version to be backwards compatible with a request from an older version, but it's impossible to predict the future and handle requests from a newer API client.
Bouncing an error back would be the safest choice.
-
On a fediverse server with a versioned client API, what would you expect to happen if an API call is made with a version number higher than what the server supports? Should it return an error? Should it take it to mean its highest supported version? Something else?
The API isn't RESTful, the version number is global for all methods (endpoints) and has the format "major.minor".
Isn't the convention to put the version in the url? e.g. /api/v3/site
In which case a too-high version gives you a 404 error.
-
Isn't the convention to put the version in the url? e.g. /api/v3/site
In which case a too-high version gives you a 404 error.
@rimu that's for RESTful APIs, mine isn't that because I dislike the concept. I just take the version as the `v` parameter
-
@rimu that's for RESTful APIs, mine isn't that because I dislike the concept. I just take the version as the `v` parameter
@grishka @rimu putting the version in the uri is an older convention and not necessarily a REST(ful) thing either. what i've seen is to use content negotiation via an Accept-Version header
basically if you use conneg then 405 Not Acceptable; if you put versions in uris then 404 Not Found; if you take some parameter or payload then i guess maybe 422 Unprocessable Entity?
Gli ultimi otto messaggi ricevuti dalla Federazione
-
@dtm No problem!
-
-
@dtm Not sure how up-to-date this is, but the documentation says:
"preview cards will not be refetched unless the link is reposted after 2 weeks from last time"
-
@julian Thanks, this all looks very helpful :)
-
@glocq@mathstodon.xyz I really found this helpful:
https://seb.jambor.dev/posts/understanding-activitypub/
And testing stuff against activitypub.academy 👍
-
Any resources on how to make an #ActivityPub application? There's the specification, which is certainly informative, but are there things like templates, tutorials...?
-
The beauty of #ActivityPub
Yes, Loops federates, and admins can enable any remote instance video posts to appear in local follower feeds AND you can even include them in the For You page ✨
-
@cyberlyra I'm sorry, I am not involved with Mastodon's team, or this request. But I do hope that after we speak out enough, this will get the prioritization it deserves, for the sake of fediverse's diversity.
