postShow Post Callback

The postShow post callback is the absolute URL of a callback function on your server. After the user finishes authoring their show, the authoring widget calls your post callback with the HTML embed code needed to include the show viewer on a page.

The post callback URL will be called as an HTTP POST with the following parameters passed in POST variables:

  • sessionKey: Session id or auth context you provided, if any
  • userId: User id you provided, if any
  • title: Title the user chose for the new show.
  • viewerHtml: The HTML code to embed directly in the viewing page
  • showIcon: URL to the icon for the show.
  • editLink: (optional customization -- see below)

This simplest implementation of this callback will just add the viewerHtml to the user's profile page (or otherwise post the content), and should reply with, e.g.

<cbPostResponse>
    <status>success</status>
    <permalink>http://mysite.mydomain.com/profile?id=51#photoshow</permalink>
</cbPostResponse>

and in the case of failure, e.g.

<cbPostResponse>
    <status>failed</status>
    <reason>Your PhotoShow couldn't be added to your site. Please try again
    in a second</reason>
</cbPostResponse>

The syntax of the callback responses is fully detailed in the CallBack Schema document in the API reference.