News

Permet de récupérer les actualités associées à une société.

Récupérer les news

GET /v1/news

Retourne la liste des actualités d'une société avec les tags et les sociétés associées.

Headers

Nom	Type	Requis	Description
x-access-token	String	oui	Clé API

Paramètres query

Nom	Type	Requis	Description
idCompany	int|int[]	conditionnel	Identifiant(s) de la société
siren	String|String[]	conditionnel	Numéro(s) SIREN
idNews	int|int[]	conditionnel	Identifiant(s) de news

TIP

Au moins un paramètre parmi idCompany, siren ou idNews est obligatoire.

Réponses

200 — OK

{
    "success": true,
    "parameters": {
        "idAccount": "string|null",
        "idCompany": "int[]|null",
        "siren": "string[]|null",
        "idNews": "int[]|null"
    },
    "newsList": [
        {
            "idNews": "int",
            "title": "string",
            "content": "string",
            "newsDate": "datetime",
            "source": "string",
            "idCompanyList": ["int"],
            "tagList": [
                {
                    "idTag": "int",
                    "title": "string",
                    "tagType": "string"
                }
            ]
        }
    ]
}

Notes :

• La liste newsList est renvoyée à la racine de la réponse (pas d'objet result, pas de champ code/message en succès).
• Le champ date s'appelle newsDate (et non date).
• idCompanyList est un tableau d'identifiants des sociétés associées à l'actualité.
• Chaque tag expose idTag, title et tagType.

400 — Bad Request

{
    "success": false,
    "message": "Paramètre idCompany, siren ou idNews nécessaire",
    "parameters": {}
}

403 — Forbidden

{
    "success": false,
    "code": 403,
    "message": "L'abonnement n'a pas accès à ces données",
    "parameters": {}
}