Page Comparison

Overview

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

...

This section provides further details on the operations related to link.

Anchor
getShorten getShorten

...

Get a bitly short URL

The getLinkInfo operation Given a long URL, getShorten operation returns a bitly short URL .

<bitly.getShorten>
        <longtUrlforShorten>{$ctx:longtUrlforShorten}</longtUrlforShorten>
        <bitlyShortDomain>{$ctx:bitlyShortDomain}</bitlyShortDomain>
 </bitly.getShorten>

Properties

• longUrl:A a long URL to be shortened
  

• domain: (optional) The the short domain to use; either bit.ly, j.mp, or bitly.com or a custom short domain
  

...

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

Anchor
getExpand getExpand

...

Get the target (long) URL .

The getExpand operation Given a bitly URL or hash (or multiple), returns the target (long) URL .

<bitly.getExpand>
    <shortUrl>{$ctx:shortUrl}</shortUrl>
</bitly.getExpand>

Properties

• shortUrl: Refers refers to one or more bitly links
  

...

Related Bitly documentation

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

Anchor
getInfo getInfo

...

Get the page title for a given bitly link

The getInfo operation Returns returns the page title for a given bitly link .

<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.

{
"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

The getLinkSave operation Saves saves a link as a bitmark in a user's history, with optional pre-set metadata .

<bitly.getLinkSave>
     <longtUrlforLinkSave>{$ctx:longtUrlforLinkSave}</longtUrlforLinkSave>            
     <titleforLink>{$ctx:titleforLink}</titleforLink>            
     <noteforLink>{$ctx:noteforLink}</noteforLink>             
</bitly.getLinkSave>

Properties

• longtUrlforLinkSave: String 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

The getLookup operation gets a link based on a long URL .

<bitly.getLookup>        
     <urlforLookup>{$ctx:urlforLookup}</urlforLookup>            
</bitly.getLookup>

Properties

• urlforLookup: an echo back of the url parameter.
  

Sample request

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

{
"urlforLookup":"http://google.com/"
}

Related Bitly documentation

Anchor
sampleconfiguration sampleconfiguration

Sample configuration

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

<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.getLinkInfo>getShorten>        
     		<longtUrlforShorten>{$ctx:longtUrlforShorten}</longtUrlforShorten>
     <bitlyLink>		<bitlyShortDomain>{$ctx:bitlyLinkbitlyShortDomain}</bitlyLink>bitlyShortDomain>            
		</bitly.getLinkInfo>getShorten>
         <respond/>
      </inSequence>
      <outSequence>
         <send/>
      </outSequence>
   </target>
   <description/>
</proxy>