Produit par Maven

Obs-Eco-API Java

Introduction

Cette api Java permet de se connecter, de s’identifier et transmettre les informations de l’observatoire économique. Son objectif est de fluidifier les échanges entres les différentes SSII et le CNAJM.

Elle s’interface avec l’API Rest de recette et de production dont la documentation se trouve : https://test.obs-eco.fr/swagger

Dépendances

Java8

Quick start

Maven

	<repositories>
		<repository>
			<id>obseco-repo</id>
			<url>https://repository.obs-eco.fr/</url>
		</repository>
	</repositories>


	<dependencies>
		<dependency>
			<groupId>fr.obs-eco.cnajmj</groupId>
			<artifactId>obs-eco-api</artifactId>
			<version>${obseco-api.version}</version>
		</dependency>
	</dependencies>

Non-maven

Récupération de l’API java via le repository avec toutes les dépendances : https://repository.obs-eco.fr/releases/fr/obs-eco/cnajmj/obs-eco-api/

Notes

Un exemple de code est fourni dans la doc

Recette

C’est le mode par défaut.

En activant le mode recette, l’url de test sera https://test.obs-eco.fr/api/v1/

Pour activer le mode recette :

  • via Code java : System.setProperty(CtObsEcoApi.OBS_ECO_MODE, ObsEcoMode.TEST.name());
  • via une variable java : -Dobseco.mode=TEST

Production

⚠️ En cours de mise en place

En activant le mode production, l’url de test sera https://prod.obs-eco.fr/api/v1/

Pour activer le mode production :

  • via le code java : System.setProperty(CtObsEcoApi.OBS_ECO_MODE, ObsEcoMode.PROD.name());
  • via une variable java : -Dobseco.mode=PROD

Gestion du Timeout

⚠️ la valeur est en ms

Trois timeout sont disponibles :

  • connexion, temps de connexion à l’API (valeur par défaut : 10s)
  • lecture, traitement des données par l’API (valeur par défaut : 100s)
  • écriture, envoi des données par l’API (valeur par défaut : 30s)

Pour modifier la valeur par défaut via le Code java : System.setProperty(CtObsEcoApi.OBS_ECO_TIMEOUT_READ_MS, 200*1000);