Skip to main content

Introduction

The TruAI Recommender provides an API to retrieve personal recommendations. Each Recommendation Engine has its own endpoints.

URL

The url of Recommender API can be retrieved from TruAI Recommendation Engine

https://{engine-name}.gjirafa.ai/

Authentication

The Recommender API uses API keys to authenticate requests. You can get your API key in the TruAI Recommendation Engine.

Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.
Authentication to the API is performed via HTTP Headers. Provide your API key as the value for the header ApiKey.
API requests without authentication will fail with response code 401 (Unauthorized).