API pública y cliente Java

1. 1
   Necesitas APL Integration y un usuario Servicio web con empresas y roles asignados. Solicita el token mediante `/api/v1/auth/service-token`; las siguientes llamadas utilizan la cabecera Authorization con Bearer y el token recibido.
2. 2
   Selecciona la empresa con `companyCode` según el contrato. El servidor comprueba empresas y permisos: nunca se cambia de configuración enviando un identificador de cliente ni se comparten tokens entre clientes.
3. 3
   Para Java utiliza el cliente generado compatible con el contrato del servidor y su documentación incluida. En Eclipse crea un proyecto Java e incorpora los fuentes de `java-client/src`, o añade el JAR al Build Path de tu proyecto. Configura Java 17; el cliente utiliza bibliotecas estándar de Java, sin dependencias externas.
4. 4
   La API pública no incluye APL Assistant, Factory View, ayuda/soporte ni el Panel APL. No intentes automatizar estos módulos mediante endpoints internos. No publiques tokens, contraseñas o ejemplos con datos de clientes.

GET /api/v1/companies
Authorization: Bearer <accessToken>

GET /api/v1/materials?companyCode=DEMO&section=articles&page=1&pageSize=25
Authorization: Bearer <accessToken>

// Java 17 · Eclipse: Java Build Path > Libraries
var client = new AplSchedulerClient(baseUrl);
client.authenticate(new ServiceCredentials(
    configuration, serviceUser, passwordFromSecretStore));
ApiResponse response = client.companies();