Skip to main content

Introduction

Talent Management System API​

Welcome to the Talent Management System API documentation! Here, you’ll find the information you need to integrate with our APIs. If you haven’t received your credentials yet, please contact us at [email protected] for assistance.

Introduction

Understanding the APIs​

In our Talent Management system, there are two primary Application Programming Interfaces (APIs) available for developers and integrators: the Classic API and the newer API (often referred to simply as the “API”). Both enable you to interact with various features and data within the Talent Management platform, but they differ in terms of capabilities, maturity, and technical foundation.

Classic API​

The Classic API is built on older architecture. Despite being considered obsolete, it continues to be available because it supports a wider range of actions than the new API. It remains useful for integrations that require a broader set of features. However, it is important to note that the Classic API will eventually be phased out, with its capabilities gradually migrating to the newer API. As this transition unfolds, some functionalities in the Classic API may change or become deprecated.

New API​

The new API is based on our latest infrastructure, which offers modern benefits such as enhanced scalability, improved performance, and stronger security measures. Although its current feature set is more limited compared to the Classic API, the new API is continuously being expanded to encompass (and potentially improve upon) the functionality of the Classic API. If you are developing new solutions, we strongly recommend using the new API whenever possible for a more future-proof integration.

API Comparison Table​

APIURLDescription
Classic APIhttps://api.<domain>.com/Older architecture; supports more features but is gradually being phased out.
New APIhttps://api-external.<domain>.com/Modern infrastructure; offers better performance, but fewer current features.

As we work toward consolidating all features into the newer API, staying informed about upcoming changes is essential. Always refer to our official documentation and release notes for the most current details on updated endpoints, migration timelines, and any anticipated deprecations.

Environments and Domains​

We provide two distinct environments for your integration:

  • Sandbox (Staging): *.tma-assessment.nl
    Use this environment to test and validate your integration before going live.
  • Production: *.tmatalents.com
    Once your solution is ready, connect to this environment for live operations.
warning

Important: Each environment requires its own set of authentication credentials. Make sure to use the correct credentials when switching between Sandbox and Production.

Using the Correct Domain​

  1. Sandbox

    • Replace <domain>.com with tma-assessment.nl
    • Example for the Classic API:
      https://api.tma-assessment.nl/

  2. Production

    • Replace <domain>.com with tmatalents.com
    • Example for the Classic API:
      https://api.tmatalents.com/
info

When moving between environments, always:

  • Update your Base URL to match the correct domain.
  • Use the corresponding authentication credentials.
  • Adjust any environment-specific configurations (e.g., OAuth tokens, API keys).

Staying Informed​

As we transition more functionality to the New API, we encourage you to keep an eye on:

  • Official documentation for updated endpoints and migration guides.
  • Change logs for announcements on upcoming deprecations and new features.

Contact​

If you need further support or have any questions, please reach out to us at [email protected].