APL Scheduler

API publique et client Java

Objectif

Connecter un consommateur au contrat public installé.

Exemple pratique

Avec un compte service web de test, listez les sociétés puis consultez avec companyCode. Dans Eclipse ajoutez le JAR et choisissez Java 17.

Des données au résultat

  1. 1Licence
  2. 2Service web
  3. 3Jeton
  4. 4Requête

La référence est dans `/api-docs` et le contrat dans `/openapi/v1.json`. Utilisez la version installée pour champs et opérations.

  1. 1
    APL Integration et un compte service web avec sociétés et rôles sont nécessaires. Demandez un jeton via `/api/v1/auth/service-token` et utilisez Authorization Bearer.
  2. 2
    Sélectionnez la société par `companyCode`. Le serveur contrôle droits et sociétés ; ne partagez pas de jetons entre clients.
  3. 3
    Dans Eclipse créez un projet Java avec `java-client/src`, ou ajoutez le JAR au Build Path. Utilisez Java 17 ; aucune bibliothèque externe n’est nécessaire.
  4. 4
    Assistant, Factory View, aide/support et Panel APL ne sont pas dans l’API publique. N’automatisez pas les endpoints internes et ne publiez aucun secret.

Référence technique

Exemple illustratif : adaptez au contrat installé et utilisez un coffre 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 ↗

Avant de terminer

OpenAPI correspond au serveur ; licence, société et rôle sont valides. Gérez 401, 403, 409 et 429 sans répéter aveuglément les écritures.

Questions fréquentes

Une option manque ou je ne peux pas modifier

Vérifiez société, licence, droits et champs gérés par intégration. Une URL directe ne contourne pas les restrictions.

Je ne trouve pas de données

Effacez les filtres et vérifiez page, dates et société. Il peut ne pas y avoir de données accessibles ; ne créez pas de doublons.

J’ai enregistré sans voir l’effet attendu

Rouvrez et vérifiez. Enregistrer ne publie pas une simulation requise. Vérifiez la première écriture avant de la répéter.

Guides liés