SharinPix DocumentationMain Documentation SharinPix features - main integrationIntegrate SharinPix Album on Your Website (Developer-oriented)

Integrate SharinPix Album on Your Website (Developer-oriented)

Introduction

Please note that you will require developer skills to be able to integrate SharinPix Album on your Website.

In this document, we will guide you through the different element you need to do to display a SharinPix album on your website.

To get started, you need to generate a JSON Web token. Learn more here: https://jwt.io/introduction
This is used to authenticate SharinPix Album. There are 4 main information required to display and interact a SharinPix Album.

  • AlbumId - the album Id on which to upload images.
  • Issuer - A key used to determine who is the owner and which organization the album and images belongs to.
  • Secret - A secret which will sign the album (we use this to verify authenticity of the requests).
  • Abilities - refers to the different permission granted to the current album

Getting Started

For this document, we will show you how to build a JWT in Javascript programming language. But this can be done similarly in any languages.

First, you need to create a SharinPix Secret. For that, you need to go the SharinPix Admin Dashboard and create the secret.

Connect to the Admin Dashboard: Overview of the SharinPix Administration Dashboard

Go to the Secrets tab and create a new one.

Building Token

We shall now construct our token. You will now need to download the appropriate JWT library depending on the programming language you are using. As mentioned earlier,  we will be using Javascript for this demo.

Link to JWT libraries: https://jwt.io/
Installation instructions are also provided there.

Below is a sample javascript code. Import appropriate library before running the code. In this case, the library was jsrsasign-all-min.js

var albumId, base_url, client_id, client_secret, params, token;
albumId = 'my_album_id'; //replace with your album id
client_id = '1bf911ea-1fff-4917-8e9e-52061846543c'; //replace with your Id from your secret
client_secret = 'GGIVjB4KcMBxUajtLfCf_wxF4wcHFesBDCMykQdgPtUBoLs'; //replace with your secret
base_url = 'https://app.sharinpix.com/';

params = {
    iss: client_id,
    path: '/pagelayout/'+albumId,
    abilities: {}
};
params["abilities"][albumId] = {
    Access: {
        see: true,
        image_upload: true,
        image_delete: true,
        image_list: true
    }
};

token = KJUR.jws.JWS.sign(null, {
            alg: "HS256",
            cty: "JWT"
        },
        JSON.stringify(params), client_secret);

The above code generates a string like this:

eyJhbGciOiJIUzI1NiIsImN0eSI6IkpXVCJ9.eyJpc3MiOiIxYmY5MTFlYS0xZmZmLTQ5MTctOGU5ZS01MjA2MTg0Nj U0M2MiLCJwYiL3BhZ2VsYXlvdXQvbXlfYWxidW1faWQiLCJhYmlsaXRpZXMiOnsibXlfYWxidW1faWQiOnsiQWNjZ XNzIjp7InNlZSI6dHJ1ZSwiaW1hZ2VfdXBsb2FkIjp0cnVlLCJpbWFnZV9kZWxldGUiOnRydWUsImltYWdlX2xpc3 QiOnRydWV9fX19.qp7TqeGUPTKA1DsNaws70_ml7SoJST9MR9A-6Duy1lE

Displaying SharinPix Album

Now to display the SharinPix album on your html page, use the following below and insert the generated token.

<iframe id="iframeId" class="sharinpix-iframe" src="https://app.sharinpix.com/post_message" width="100%" height="100%"/>
    
<script>
    var token = "<your-generated-token>"
    var iframe = document.getElementById('iframeId')
    iframe.onload = function() {
        iframe.contentWindow.postMessage({ token: token}, 'https://app.sharinpix.com');
    }      
</script>

Contact SharinPix support in case you are having difficulties implementing these.

0 Comments

Add your comment

E-Mail me when someone replies to this comment