deemly system guide
We are trying to make your life as a developer as easy as possible. We strive to have thorough documentation for our API and our login functionality.
If you have a business account with us, you will find all needed technical documentation there regarding accessing, pulling, and pushing data through our REST API and how to use our JS widgets.
But before you dive further into the code, let us quickly walk you through the needed steps for a full integration of the deemly score widget for your users, the Review & Rating System, and lastly give the deemly users the option to authorise and include their reviews and ratings from your site through the serverside REST API. Let us take it in three steps:
1. Show your users’ deemly score
In order for your users to display their deemly score, you need to call our API with their deemly ID. This means your users need to have saved their deemly ID to their profile on your site.
So how do they do this? There are basically two ways:
- Use the login with deemly functionality
- Users saves their ID manually
Let’s go through the two options:
1. Working with the deemly login provider
You can create a free deemly developer account and find documentation on how to integrate the deemly login. This gives your users the option to create an account or just to pass on their deemly ID to you with a click of a button – like you know from login with facebook and google+.
2. Users add the ID by themselves
This means you give your users an input field on their ‘Edit Profile’-page where they can copy and paste in their ID. We have created a small login page, which you can open in an iframe, in an overlay or in a new window so they can easily get their ID. You can try out the link here: Get my deemly ID
Whether you choose option 1 or 2, your users will have their deemly ID saved on your site and from here you can display the deemly scrore widget in your view or template by calling our API and retrieve the data.
2. Let your users authorise their account with you at deemly
The next thing we need to have in place is a way for deemly users to authorise their account on your site on their deemly profile. This means you need to offer us a way for fetching their user ID from your site.
This can be done in many ways, oauth2 and OpenID, a login service you have build your self or more simply a way for us to get the ID based on an email. We are always open to discuss possibilities and options, reach out to us at firstname.lastname@example.org.
3. Integrate the deemly Review & Rating system
The last step is to implement the actual Review and Rating system on your site. This is probably the easiest of the three steps. You simply build your form for letting users review each other and post the data to us through our API. This way, you have full flexibility over flows and design to fit your site. As for showing a users’ reviews and ratings, we also have an API call for that. Please refer to the documentation and code examples on your business account.
With these three steps done you are fully integrated into the deemly eco system: The deemly score widget on your users site, your site on the deemly profile as well as the Review and Rating system for your users.
Check out the deemly score