<aside> 📜

The advanced analytics and API access are available in Evocon Professional and Enterprise packages.

</aside>

<aside> 📜

This guide provides comprehensive instructions for using the Evocon reporting API prebuilt endpoints to pull production data from Evocon into external systems like Power BI, Excel, or custom applications for advanced analytics and tracking.

</aside>

1. Authentication

Access to the Evocon API is controlled by API keys using Basic Authentication.

1.1 Generating an API Key

Only Company and Factory administrator users in Evocon can generate API keys.

1. Navigate to Settings in your Evocon account and click on the API keys card.

1. Click the + API KEY button in the top right corner.

2. Assign a descriptive name to the key that explains where it will be used.

3. Choose the key's rights:

   • Custom reports: This option grants read-only access to the api.evocon.com/api/reports/... URL. It is used for connecting Evocon reporting data to tools like Excel or Power BI and provides access to all stations' data.
   • User rights: This option copies the access rights of an existing user, which can include read-write access for specific stations. It is intended for more complex integrations, such as sending production orders to Evocon or building API-based automations.

   

4. Click Create to generate the key.

❗ Important: Save Your Secret Key

When you create a key, you will be shown an API Key (which acts as the username) and a Secret Key (which acts as the password). The Secret Key is shown only once. You must save it in a secure location immediately, as it cannot be retrieved again.

1.2 Using Your API Key

The API uses Basic Authentication. How you provide the credentials depends on your application.

• Method 1: For Tools (Excel, Power BI, etc.) These applications provide built-in fields for Basic Authentication.
  • Username: Enter your API Key (e.g., EVO123456789).
  • Password: Enter your Secret Key (e.g., SeCrEtKeY123).

• Method 2: For Custom Applications (Authorization Header) You must manually create a Base64-encoded Authorization header using a service like https://www.base64encode.org/
  1. Concatenate the API Key and Secret Key with a colon (:): API key:Secret key (Example: EVO123456789:SeCrEtKeY123).
  2. Base64 encode this entire string. (Example: RVZPMTIzNDU2Nzg5OlNlQ3JFdEtlWTEyMw==).
  3. Include this in your request header: Authorization: Basic RVZPMTIzNDU2Nzg5OlNlQ3JFdEtlWTEyMw==