x-callback-url

Pincase supports x-callback-url. You can launch Pincase from other apps, and make use of its powerful features, directory from those apps.

 
 
 

What is x-callback-url?

x-callback-url is a technical specification that enables iOS app to make their functions available to other apps. For more detail on x-callback-url, please visit here.

Create bookmark

You can create bookmarks from other apps. After adding bookmark, unless there're x-success/x-error/x-cancel specified, Pincase will try to detect which app you are from and redirect you back to the original app. (Only works for Safari, Chrome, Sleipnir and Sleipnir Black Edition)

URL Scheme

pincaseapp://x-callback-url/add


Example 1

pincaseapp://x-callback-url/add?url=https%3A%2F%2Fpincaseapp.com%2F&title=Pincase%20-%20A%20simple%2C%20elegant%20and%20powerful%20Pinboard.in%20client%20for%20iOS&noui=yes&later=yes

In detail

Above example is adding "https://pincaseapp.com/" as a "Unread" bookmark.
Title will be "Pincase - A simple, elegant and powerful Pinboard.in client for iOS".
No "private" parameter is specified, so app will see the "Add as Private" setting within the app in order to decide privacy.
No composer UI will be displayed.

Parameters

Parameter Value Description
url
required
TARGET_URL URL to bookmark.
Value must be URL encoded UTF-8 string
title
optional
TITLE Title for the URL.
Value must be URL encoded UTF-8 string. If you omit this parameter, title will be empty.
private
optional
yes/no Bookmark should be private or public
If nothing specified, app will use "Add as Private" setting in the app.
toread
optional
yes/no Bookmark is unread or not
If you ommit this parameter, the app consider it as "yes".
noui
optional
yes/no if no, no UI will be shown
If nothing specified, app will show the UI.
x-success
optional
URL_SCHEME if you want redirect back after the action, specify URL scheme here
x-error
optional
URL_SCHEME if you want redirect back after the action, specify URL scheme here
x-cancel
optional
URL_SCHEME if you want redirect back after the action, specify URL scheme here

Launch Pincase app

You can launch Pincase app from other apps.

URL Scheme

pincaseapp://x-callback-url/open


Example 1

pincaseapp://x-callback-url/open?mode=public_tag&tag=iOS

In detail

Above example opens Pincase app, shows the public feed that is public on Pinboard.in


Example 2

pincaseapp://x-callback-url/open?mode=personal_unread

In detail

Above example opens Unread bookmarks screen in Pincase.

Parameters

Parameter Value Description
mode
optional
menu Open menu
personal_unread Open unread bookmark
personal_recent Open recent bookmark
personal_tag Open recent bookmark
public_popular Open popular bookmark
public_recent Open popular bookmark
public_japanese Open public tag
specify tag parameter
public_wikipedia Open public tag
specify tag parameter
public_fandom Open public tag
specify tag parameter
public_favorite_stream Open public tag
specify tag parameter
public_tag Open public tag
specify tag parameter
public_username Open public tag
specify tag parameter
tag
optional
TAGNAME Use with mode=personal_tag or mode=public_tag
username
optional
USERNAME Use with mode=personal_tag or mode=public_tag

* x-source, x-success, x-error, x-cancel will not work for this action

Developer

For more information about URL Scheme and bookmarklet, click here.

Press

For press release, logos and screenshots, visit here.

FAQ

If you have questions regarding the app, please visit, here.

Need some help?

For quick answers or help, follow us.