Carrier Integration
===================

The *carrier* integration is the simplest one
possible.

In general, these are the high level steps:

1. Send to our team your MC, DOT Number and your public key
2. We will set you up on our *sandbox* environment and
   will return to you two pieces of information: **issuer**
   and **account uuid**.
3. In your application, configure these two values, for the testing
   environment, using environment variables or any other method you prefer.
   You need these values to properly sign the tokens for **sys calls** and for
   **usr calls**

Scopes
******

In this scenario the calls you will be able to do are limited by
the scopes Loadsmart's team configures for your *token*. There are
several scopes available and each scope will allow you one or more
calls.

The scope necessary can be found in the `documentation`_, in the
**Authorization** field for each endpoint.

In the `Create Capacity endpoint`_, there is two bits of information
available on the **Authorization** field:

1. Type of token required (**User-JWT**)
2. Scope required (**capacity-write**)

.. image:: /images/authorization-type-scopes.png

For more details check: :doc:`/authentication-authorization/index`.

.. _documentation: https://developer.loadsmart.com/api
.. _Create Capacity endpoint: https://developer.loadsmart.com/api/#tag/Capacity/paths/~1api~1v2~1capacity/post