Developer Documentation
=======================

GroupVAN (Group's Value Added Network) provides integration services for the
automotive aftermarket industry. The GroupVAN Gateway connects buyer and seller
systems through a unified platform capable of interacting with multiple
third-party integrations, networks and specialized aftermarket automotive
technology. Translation of data between systems and formats occurs in real time,
providing a seamless ordering and catalog experience.

Getting Started
---------------

GroupVAN uses standard REST endpoints with GET and POST methods. All
communication is stateless and requires HTTPS.

.. important::

    GroupVAN only accepts requests sent via HTTPS.

**Data Format**

All requests and responses use `JSON <https://en.wikipedia.org/wiki/JSON>`_ format.

**Authentication**

Authentication is handled via a self-signed `JWT <https://en.wikipedia.org/wiki/JSON_Web_Token>`_
(JSON Web Token). The token contains embedded information about the client and
the resources it can access. Please speak with your GroupVAN integrator to
receive your credentials.

**Required Headers**

All requests must include the following headers:

.. code-block:: none

    Content-Type: application/json
    Authorization: Bearer eyJhbGciOiJIUzI1...

.. toctree::
   :maxdepth: 3
   :hidden:

   gateway/authentication
   gateway/index
   reference/common-codes
   api_v2/index
   api_v2_1/index
   api_v3/index