Poster for Developers

The URL schema registered by Poster is “posterapp://”, and supports a single /create action.

If you’re interested in supporting the URL schema with a Send-to-Poster action, feel free to send me an .

/create

The create function supports the following post-related parameters, in addition to a callback URL:

  • title, string, optional
  • text, string, optional
  • callback_url, string, optional, (v2.0+)
  • customfield_<fieldname>, string, optional, (v2.0.2+)

The callback URL is called when a currently editing post is dismissed, either when it is published, closed and saved, or canceled. All text should be URL encoded.

The URL scheme is customizable and can be used with any custom field name for a given blog (examples below). If a URL is received by Poster containing a custom field previously not set-up within the app, the field will be added to the blog associated with the post.

Examples

Creates a new post with designated text:

  • posterapp:///create? text=<text>

Creates a new post with designated text and title:

  • posterapp:///create? text=<text>&title=<title>

Creates a new post with designated text and title, and will attempt to open the provided callback_url upon completion:

  • posterapp:///create? text=<text>&title=<title>&callback_url=<callback_url>

Creates a new post with designated text and title, and will attempt to open the provided callback_url upon completion. Two custom fields will be applied to the post:

  • posterapp:///create? text=<text>&title=<title>&callback_url=<callback_url>&customfield_<fieldNameOne>=<valueOne>&customfield_<fieldNameTwo>=<valueTwo>