IndieWebCamp is a 2-day creator camp focused on growing the independent web

Web Action URL APIs

A list of web (and native) services currently providing URLs which could be made the basis of a Web Actions implementation.

Web-based actions are invariably http:// URLs, whereas native actions (well-known and custom) often utilise other URI schemes. These vary from the well known (e.g. mailto:) to custom schemes, e.g twitter://.

On sending a GET request to an Action endpoint, the typical result is to display an interface for carrying out the relevant action, optionally preloaded with text provided in query string parameters.

Contents

Web

IndieWebCamper's Implementations

  • User:Aaronparecki.com has a URL endpoint for posting new notes/replies which he forces twitter to use for him as demonstrated here.
    • A particularly interesting aspect of this implementation is that the only query string parameter is in_reply_to URL, and it looks like he's parsing twitter usernames out of that server side
  • Barnaby Walters has a URL API for creating new notes, which accepts several query string params, inReplyTo, text and tags
    • I have plans to add more, and more dynamic functionality (e.g. loading text from h-entry markup of an inReplyTo URL so I can quote it really easily) --Waterpigs.co.uk 11:30, 2 March 2013 (PST)

URL APIs To Review

  • … add here

Mac OS

Mac apps can register with the OS to handle custom URL schemes (e.g. twitter://), which activate the app, optionally in a certain context (e.g. new tweet with text)

  • Twitter's Mac app registers the twitter:// URI scheme and exposes the following endpoints:
    • twitter://post?message=urlencoded+text+of+tweet
    • twitter://user?screen_name=twitter_screen_name

iOS

iOS is an interesting case, as not only can apps register custom URL schemes (as on Mac OS), there are several built in handlers for fully-qualified URLs, e.g. youtube URLs and Google Maps URLs.

  • These apps no longer exist on iOS 6, do the URLs still work? --Waterpigs.co.uk 02:01, 20 September 2012 (PDT)
  • A great many are documented here: [1]
  • As on Mac, Twitter's iOS app registers the twitter:// URI scheme and exposes the following endpoints:
    • twitter://post?message=urlencoded+text+of+tweet
    • twitter://user?screen_name=twitter_screen_name
    • Apparently most of the old Tweetie endpoints also work
  • Most Twitter clients offer similar endpoints, but Tweetbot have done a particularly good job of documenting theirs - note the callback URL parameter!