APL Scheduler

API pubblica e client Java

Obiettivo

Collegare un consumatore al contratto pubblico installato.

Esempio pratico

Con account servizio web di prova elenca aziende e leggi con companyCode. In Eclipse aggiungi JAR al Build Path e Java 17.

Dai dati al risultato

  1. 1Licenza
  2. 2Servizio web
  3. 3Token
  4. 4Richiesta

Riferimento: `/api-docs`; contratto: `/openapi/v1.json`. Usa la versione installata per campi e operazioni.

  1. 1
    Servono APL Integration e utente servizio web con aziende e ruoli. Richiedi token via `/api/v1/auth/service-token` e usa Authorization Bearer.
  2. 2
    Scegli l’azienda con `companyCode`. Il server verifica accessi; non condividere token tra clienti.
  3. 3
    Crea in Eclipse un progetto Java con `java-client/src` oppure aggiungi il JAR al Build Path. Usa Java 17, senza librerie esterne.
  4. 4
    Assistant, Factory View, aiuto/supporto e pannello APL non sono API pubblica. Non automatizzare endpoint interni né pubblicare segreti.

Riferimento tecnico

Esempio illustrativo: adatta al contratto installato e usa un archivio segreti.

Java 17 / HTTP→Bearer · companyCode→APL Scheduler
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();
OpenAPI ↗OpenAPI JSON ↗

Prima di terminare

OpenAPI coerente col server, licenza, azienda e ruolo validi. Gestisci 401, 403, 409 e 429 senza ripetere scritture alla cieca.

Domande frequenti

Manca un’opzione o non posso modificare

Verifica azienda, licenza, permessi e campi integrati. Un URL diretto non supera le restrizioni.

Non trovo record

Pulisci filtri e verifica pagina, date e azienda. Potrebbero mancare dati accessibili; non creare duplicati.

Ho salvato senza l’effetto previsto

Riapri e verifica. Salvare non pubblica una simulazione necessaria. Controlla la prima scrittura prima di ripeterla.

Guide correlate