Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

The following operations allow you to work with Links. Click an operation name to see details on how to use it.

...

Code Block
languagexml
titlegetShorten
<bitly.getShorten>
        <longtUrlforShorten>{$ctx:longtUrlforShorten}</longtUrlforShorten>
        <bitlyShortDomain>{$ctx:bitlyShortDomain}</bitlyShortDomain>
 </bitly.getShorten>
Properties
  • longUrl:a long URL to be shortened

...

Code Block
languagexml
titlegetExpand
<bitly.getExpand>
    <shortUrl>{$ctx:shortUrl}</shortUrl>
</bitly.getExpand>
Properties
  • shortUrl: refers to one or more bitly links

...

Related Bitly documentation

http://dev.bitly.com/links.html#v3_expand

...

Code Block
languagexml
titlegetInfo
<bitly.getInfo>        
     <shortUrlforInfo>{$ctx:shortUrlforInfo}</shortUrlforInfo>
     <expandUserinfo>{$ctx:expandUserinfo}</expandUserinfo>            
</bitly.getInfo>
Properties
  • shortUrlforInfo: Refers to one or more bitly links.

  • expandUserinfo: (optional) true| false – include extra user info in response.

...

Following is a sample REST/JSON request that can be handled by the getInfo operation.

Code Block
languagexml
titleSample Request for getInfo
{
"shortUrlforInfo":"http://bbc.in/1ngDL1b",
"expandUserinfo":"true"
}
Related Bitly documentation

http://dev.bitly.com/links.html#v3_info

Anchor
getLinkSave
getLinkSave
Saving a link as a bitmark in a user's history, with optional pre-set metadata

...

Code Block
languagexml
titlegetLinkSave
<bitly.getLinkSave>
     <longtUrlforLinkSave>{$ctx:longtUrlforLinkSave}</longtUrlforLinkSave>            
     <titleforLink>{$ctx:titleforLink}</titleforLink>            
     <noteforLink>{$ctx:noteforLink}</noteforLink>             
</bitly.getLinkSave>
Properties
  • longtUrlforLinkSave: string to query for.

  • titleforLink: (optional) the title of this Bitlink.

  • noteforLink: (optional) a description of, or note about, this Bitlink.

  • private: (optional) boolean true or false indicating privacy setting (defaults to user-level setting).

...

Related Bitly documentation

http://dev.bitly.com/links.html#v3_user_link_save

Anchor
getLookup
getLookup
Query for a bitly link based on a long URL

...

Code Block
languagexml
titlegetLookup
<bitly.getLookup>        
     <urlforLookup>{$ctx:urlforLookup}</urlforLookup>            
</bitly.getLookup>
Properties
  • urlforLookup: an echo back of the url parameter.

...

Following is a sample REST/JSON request that can be handled by the getLookup operation.

Code Block
languagexml
titleSample Request for getLookup
{
"urlforLookup":"http://google.com/"
}

...

Following is a sample proxy service that illustrates how to connect to Bitly with the init operation and use the getShorten operation. The sample request for this proxy can be found in getLinkInfo getShorten sample request.

Code Block
languagexml
titleSample Proxy
<proxy xmlns="http://ws.apache.org/ns/synapse"
       name="bitly"
       transports="https,http"
       statistics="disable"
       trace="disable"
       startOnLoad="true">
   <target>
       <inSequence onError="faultHandlerSeq">
         <property name="accessToken" expression="json-eval($.accessToken)"/>
         <property name="bitlyLink" expression="json-eval($.bitlyLink)" />
         <bitly.init>
            <accessToken>{$ctx:accessToken}</accessToken>
         </bitly.init>
         <bitly.getShorten>        
     		<longtUrlforShorten>{$ctx:longtUrlforShorten}</longtUrlforShorten>
     		<bitlyShortDomain>{$ctx:bitlyShortDomain}</bitlyShortDomain>            
		</bitly.getShorten>
         <respond/>
      </inSequence>
      <outSequence>
         <send/>
      </outSequence>
   </target>
   <description/>
</proxy>