[This is preliminary documentation and is subject to change.]

HOMAG Connect provides the ability to seamlessly integrate HOMAG applications into existing business processes and systems through programmatic access.

Our public API uses Basic Authentication.
Authentication credentials consist of:

• Username: Your SubscriptionId (GUID)
• Password: A password generated by you in the management interface

You can create or revoke this password at any time.

You, as the customer, are fully responsible for securely storing and protecting your API credentials.
These credentials grant full access to all API endpoints available to your subscription, including operations that may modify or delete data. Improper handling can lead to unauthorized access and potential data loss.

The API password must never be used or stored in any client‑side or publicly accessible environment, such as:

• Browser-based JavaScript
• Frontend web applications
• Mobile apps or desktop apps that can be decompiled
• Public repositories or shared configuration files

Any environment where the password can be viewed, extracted, or intercepted by end users is strictly forbidden.

The password may only be used in:

• Secure backend systems
• Server-side services
• Machine-to-Machine (M2M) communication
• Applications that are not publicly distributed and cannot be accessed or inspected by end users

If you suspect that your password has been exposed:

1. Immediately delete it in the management interface
2. Generate a new password
3. Update your backend systems accordingly

By using this API, you confirm that:

• You are solely responsible for the protection of your access credentials
• You ensure that passwords are stored securely and used only in secure environments
• Any misuse resulting from insecure storage or exposure of credentials falls under your responsibility

There are HOMAG Connect Clients available for the following applications:

1. MMR Mobile
   Documentation for HOMAG Connect MMR Mobile Client and some samples for the usage.

2. intelliDivide
   Documentation for intelliDivide Client and some samples for the usage.

3. materialManager
   Documentation for materialManager Client and some samples for the usage.

4. materialAssist
   Documentation for materialAssist Client and some samples for the usage.

5. productionManager
   Documentation for productionManager Client and some samples for the usage.

6. productionAssist
   Documentation for productionAssist Client and some samples for the usage.

7. orderManager
   Documentation for orderManager Client and some samples for the usage.

For detailed information and prerequisites for each, we recommend that you refer to the documentation provided for each specific application. This will ensure that you have a clear understanding of the details and requirements necessary for successful integration into your processes.

The HOMAG Connect Clients also offer tapio partners the opportunity to integrate and optimize processes for their customers by integrating the HOMAG applications. Please refer to the partner documentation for more information.

If you find something, feel free to contribute to this repository. We appreciate every improvement ❤️.