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

IndieWeb Support

  • Aaron Parecki 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)
  • Anyone using WordPress since 2.7 (?) can use the Press This endpoint and u/t/s/i query params to pre-fill a “new post” form
  • Jeremy Keith has a bookmarklet-invoked URL API for adding links to his link blog

Silo Endpoints

tt-rss

Twitter

Twitter's Activities

Facebook

Open Source Implementations

  • Storytlr provides a URL API on it’s posting UI. The post Title, Body and URL to use can be set using the t, s and u query parameters.

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!