[comment]: # ({3466d178-389b3928})
# history.push

[comment]: # ({/3466d178-389b3928})

[comment]: # ({5e478835-a90ea165})
#### Description

`object history.push(object/array itemHistoryData)`

Cette méthode permet d'envoyer les données d'historique des éléments au serveur Zabbix.

::: noteclassic
Cette méthode est disponible pour les utilisateurs de tout type.
Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur.
Consultez [User roles](/manual/web_interface/frontend_sections/users/user_roles) pour plus d'informations.
:::

[comment]: # ({/5e478835-a90ea165})

[comment]: # ({fecb3622-e0163c70})
#### Paramètres

`(object/array)` Données d'historique de l'élément à envoyer.

La méthode prend en charge les paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|ID de l'élément associé.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire* si `host` et `key` ne sont pas définis|
|host|string|Nom technique de l'hôte.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire* si `itemid` n'est pas défini|
|key|string|Clé de l'élément.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire* si `itemid` n'est pas défini|
|value|mixed|Valeur de l'élément.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire*|
|clock|timestamp|Heure à laquelle la valeur a été reçue.|
|ns|integer|Nanosecondes au moment où la valeur a été reçue.|

[comment]: # ({/fecb3622-e0163c70})

[comment]: # ({a55f92a5-d10d10b9})
#### Valeurs de retour

`(object)` Renvoie le résultat de l’opération d’envoi des données.

[comment]: # ({/a55f92a5-d10d10b9})

[comment]: # ({4c860844-6892d8c2})
#### Exemples

[comment]: # ({/4c860844-6892d8c2})

[comment]: # ({b319fb61-c6721628})
##### Envoyer les données d'historique des éléments

Envoyez les données d'historique des éléments au serveur Zabbix pour les éléments « 10600 », « 10601 » et « 999999 ».

[Requête](/manual/api#performing-requests) :

```json
{
    "jsonrpc": "2.0",
    "method": "history.push",
    "params": [
        {
            "itemid": 10600,
            "value": 0.5,
            "clock": 1690891294,
            "ns": 45440940
        },
        {
            "itemid": 10600,
            "value": 0.6,
            "clock": 1690891295,
            "ns": 312431
        },
        {
            "itemid": 10601,
            "value": "[Tue Aug 01 15:01:35 2023] [error] [client 1.2.3.4] File does not exist: /var/www/html/robots.txt"
        },
        {
            "itemid": 999999,
            "value": 123
        }
    ],
    "id": 1
}
```

Réponse :

```json
{
    "jsonrpc": "2.0",
    "result": {
        "response": "success",
        "data": [
            {
                "itemid": "10600"
            },
            {
                "itemid": "10600"
            },
            {
                "itemid": "10601",
                "error": "L'élément est désactivé."
            },
            {
                "error": "Aucune autorisation pour l'objet référencé ou celui-ci n'existe pas."
            }
        ]
    },
    "id": 1
}
```

[comment]: # ({/b319fb61-c6721628})

[comment]: # ({57c06937-f4799610})
#### Voir aussi

- Éléments [Trapper items](/manual/config/items/itemtypes/trapper#sending-data)
- Éléments [HTTP agent](/manual/config/items/itemtypes/http)
- [Host](/manual/api/reference/host/object#host)
- [Item](/manual/api/reference/item/object#item)

[comment]: # ({/57c06937-f4799610})

[comment]: # ({7e832fdb-b99de764})
#### Source

CHistory::push() dans *ui/include/classes/api/services/CHistory.php*.

[comment]: # ({/7e832fdb-b99de764})