Client Documentation
RoamFree
Backend

Backend

Session Management

RoamFree uses the anonymous session capabilities of the Imminently Fabric. This allows for anonymous users (eg: those that don't have an Azure Active Directory login yet) to access and interact with the backend services. This works in the following way:

  • When a user requests a service and does not provide a Bearer Token (which would trigger the normmal AD token verification) the backend will generate a unique session id.
  • It provides this in the X-SESSION header in the response
  • On subsequent calls to keep the 'user' context, provide the X-SESSION value in the request header. The backend will use this to effectively save people's filter data

Services

  • Finder: Main interaction point for the filter. Provide filter inputs and then the backend will return the countries you are potentially eligible for
  • Interview: Runs the guided interviews available within the RoamFree site. This is effectively a wrapper over the interview endpoints for Decisively