APL Scheduler

API pública i client Java

Què aprendràs

Connectar un consumidor al contracte públic instal·lat.

Exemple pràctic

Amb compte servei web de prova llista empreses i consulta amb companyCode. A Eclipse afegeix JAR al Build Path i Java 17.

De les dades al resultat

  1. 1Llicència
  2. 2Servei web
  3. 3Token
  4. 4Petició

Referència: `/api-docs`; contracte: `/openapi/v1.json`. Usa la versió instal·lada per a camps i operacions.

  1. 1
    Calen APL Integration i usuari servei web amb empreses i rols. Demana token a `/api/v1/auth/service-token` i usa Authorization Bearer.
  2. 2
    Tria empresa amb `companyCode`. El servidor valida accessos; no comparteixis tokens entre clients.
  3. 3
    Crea a Eclipse un projecte Java amb `java-client/src` o afegeix el JAR al Build Path. Usa Java 17, sense biblioteques externes.
  4. 4
    Assistant, Factory View, ajuda/suport i Panell APL no són API pública. No automatitzis endpoints interns ni publiquis secrets.

Referència tècnica

Exemple il·lustratiu: adapta al contracte instal·lat i utilitza un magatzem de secrets.

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 ↗

Abans d’acabar

OpenAPI correspon al servidor, llicència, empresa i rol vàlids. Gestiona 401, 403, 409 i 429 sense repetir escriptures a cegues.

Dubtes freqüents

Falta una opció o no puc editar

Comprova empresa, llicència, permisos i camps integrats. Una URL directa no supera restriccions.

No trobo registres

Neteja filtres i comprova pàgina, dates i empresa. Pot no haver-hi dades accessibles; no creïs duplicats.

He desat sense l’efecte esperat

Reobre i comprova. Desar no publica una simulació necessària. Comprova la primera escriptura abans de repetir.

Guies relacionades