Skip to main content

Integration

Introduction

For first phase of integrating MRE into MyCRM, we've decided to:

  • Add a way to open MRE (iframe or new tab) from MyCRM with ready loaded data for generating a report
  • MyCRM will communicate to MRE data (inputs) required to calculate a specific case via an endpoint provided by MRE - Create a session
  • Data is stored in "sessions" which can be loaded by passing a session ID as URL parameter to BlackFin hosted frontend of MRE tool - https://mre.blackfin.tools/

 

 

API

Server to server API

MortgageThe Recommendation EngineMRE exposes JSONa RESTful API which uses standard HTTP response codes, authentication, and verbs.

verbs,

and uses JSON payloads. The API is hosted on environment-specific domains:

    Development: Environment API Base URL Test https://api.mre.test.blackfin.tools/ Live: Production https://api.mre.blackfin.tools/

     

    Endpoints

    API endpoints are represented as paths appended to the base URL. For example, create a session endpoint URL is:

    https://api.mre.test.blackfin.tools/sessions/create

    Each environment has a matching MRE UI:

      Development: https://mre.test.blackfin.tools/ Live: https://mre.blackfin.tools/
      Authentication

      The API uses the Bearer token authentication method. That means HTTP Header Authorization should contain string:

       

      Bearer <API_KEY>

      Where <API_KEY> is replaced by anthe API key issued to you by BlackFin.

      Environments

       

      API for

      MyCRM

      User isInterface

      available

      The onlyMortgage onRecommendation developmentEngine environment.UI Thiscan environmentbe isaccessed

      Environment Web URL Test https://mre.test.blackfin.tools/ Production https://mre.blackfin.tools/

      The UI does not productioncurrently readyrequire andenforce shouldany be used sparingly.authentication


      Back to top