.. _sandbox:

Public sandbox
==============

.. note::
    OpenFHIR is a powerful engine designed to process and transform healthcare data using between FHIR and openEHR.

If you want to explore the openFHIR engine without setting up a local instance, you can freely access our public sandbox at https://sandbox.open-fhir.com .

This sandbox allows you to follow the :doc:`tutorial` or test any custom evaluation scenarios at no cost. If you would like to evaluate openFHIR outside the scope of this tutorial, please request access at https://open-fhir.com#access. Access will be provided immediately via email.

Obtaining an Access Token
-------------------------

To interact with the openFHIR sandbox, you'll need an access token for authentication. You can obtain one using the following `curl` command:

.. code-block:: bash

   curl --location 'https://sandbox.open-fhir.com/auth/realms/open-fhir/protocol/openid-connect/token' \
   --header 'Content-Type: application/x-www-form-urlencoded' \
   --data-urlencode 'client_id=your-client-id' \
   --data-urlencode 'client_secret=your-client-secret' \
   --data-urlencode 'grant_type=client_credentials'

Replace `your-client-id` and `your-client-secret` with the credentials provided to you after you've obtained access at https://open-fhir.com#access

Once executed, this command will return a JSON response containing the access token. You can use this token to authenticate requests to the :ref:`restful`.

Your Environment
----------------

As openFHIR supports multitenancy, the :ref:`state-configuration` you create as part of your setup is completely isolated to your user. While we do not offer any SLA nor guarantee uptime for this public sandbox, you can still confidently use it to evaluate openFHIR or even run a limited proof of concept (PoC) with it.

Do note, however, that the sandbox may be cleared without any advance notice.

For additional assistance, feel free to reach out at info@open-fhir.com.