Integration with rfrnc.me

Why would I integrate with rfrnc.me?

rfrnc.me was built to be a library of references for everyone, this means that being able to hook into that information is very beneficial to everyone relying on references.

How can I integrate with rfrnc.me?

rfrnc.me exposes its resources by implementing "Open Auth 2" - "Resource owner credentials grant", which is both the simplest and well suited for remote services or applications that will occasionally request the information from rfrnc.me and store them locally. If your project requires further security or rely on frequent access to the references - please contact us and we will be able to help.

The steps to integrate with rfrnc.me usually involve 3 simple steps:

  1. Register your project with rfrnc.me by contacting us and we will issue you with your "client_id" key that we will require you to use.
  2. Once you have your "client_id", please include our JavaScript SDK on your website by using the following snippet of code
    <script>
      window.rfrncmeInit = function() {
        RFRNC.init({
          clientId   : 'client-id-you-have-received-from-us',
          version    : 'v1.0'
        });
      };
    
      (function(d, s, id){
         var js, fjs = d.getElementsByTagName(s)[0];
         if (d.getElementById(id)) {return;}
         js = d.createElement(s); js.id = id;
         js.src = "https:///assets/js/js_sdk.js";
         fjs.parentNode.insertBefore(js, fjs);
       }(document, 'script', 'rfrnc-jssdk'));
    </script>
                      

    Just replace "client-id-you-have-received-from-us" in the above snippet with the key you have received from us and you're ready to go.
  3. Next step is to place a button on your page that will trigger the process and fetch references from rfrnc.me, you can do this by placing the following snippet anywhere on your website:
    <button onclick="RFRNC.fetch({success:function(response) {console.log(response);}, error: function(response) {console.log(response);}});">CLICK ME </button>

    The above snippet will initiate the "fetch" action on the SDK object and fetch "references" and "employment_history" objects and then call inline function that will alert the response on the screen.
  4. There is no need to maintain the token in your backend as the JS SDK will store its authorization token in the browser's local storage for duration of 1 week. Further options might be possible here. Once the token is valid any calls to "fetch" function will occur without user's involvement as long as your project is still authorized by the user. Users can control what projects can access their data on their rfrnc.me account page.
  5. Once the request comes back it is down to you to extract the relevant information and populate your form. Once you store the copy of the data - the process finishes.