> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/fr/api/about.md).

# À propos

Découvrez comment les terminaux de l'API REST de PowerShell Universal exécutent des scripts PowerShell, configurent les environnements d'exécution et optimisent la performance des processus d'API.

Universal offre la possibilité de définir des terminaux d'API REST à l'aide de PowerShell. Lorsque les terminaux sont exécutés par un client HTTP compatible, le script PowerShell s'exécute et retourne le résultat à l'utilisateur final.

{% hint style="info" %}
Cette fonctionnalité sert à développer des API personnalisées exécutées par Universal. Elle n'est pas requise pour gérer Universal. Universal fournit un ensemble d'API de gestion incluses avec la plateforme.
{% endhint %}

## Environnement d'exécution

L'environnement d'exécution de l'API REST fonctionne dans votre version par défaut de PowerShell. Contrairement aux tâches d'automatisation, qui peuvent aussi être exécutées via l'API de gestion d'Universal, les API que vous définissez sont exécutées dans un seul processus PowerShell. Comme le processus PowerShell n'est pas démarré et arrêté à chaque appel au terminal, l'API est beaucoup plus rapide.

Vous pouvez définir l'[environnement ](/powershell-universal/fr/config/environments.md)qui exécute le processus d'API de PowerShell Universal en spécifiant `-ApiEnvironment` sur `Set-PSUSetting`. La modification de ce paramètre entraînera le redémarrage du processus d'API.

```powershell
Set-PSUSetting -ApiEnvironment '7.1'
```

### Environnement par terminal

Vous pouvez également définir l'environnement utilisé en spécifiant l'environnement sur le terminal lui-même.

```powershell
New-PSUEndpoint -Url /environment -Environment Integrated -Endpoint {
    $PSUEnvironment
}
```

### Performance

La performance est relative au matériel et aux conditions du réseau sur lesquels vous exécutez Universal. Cela dit, dans des conditions idéales, vous pouvez vous attendre à ce que les API d'Universal traitent environ 500 requêtes par seconde. Cela se rapporte à un terminal entièrement vide, donc tout script que vous ajoutez à ce terminal réduira le débit. La réduction du débit dépendra des applets de commande et du script exécutés dans le terminal d'API. Il n'y a aucune limite absolue.

Consultez le [blogue Devolutions](https://devolutions.net/blog/) pour obtenir des informations détaillées sur les tests de performance des API d'Universal.

### Variables

Les variables sont répertoriées sur la [page des variables](/powershell-universal/fr/plateforme/variables.md#api).

## API

* [New-PSUEndpoint](/powershell-universal/fr/commandes-powershell/new-psuendpoint.md)
* [Get-PSUEndpoint](/powershell-universal/fr/commandes-powershell/get-psuendpoint.md)
* [Remove-PSUEndpoint](/powershell-universal/fr/commandes-powershell/remove-psuendpoint.md)
* [Set-PSUSetting](/powershell-universal/fr/commandes-powershell/set-psusetting.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/fr/api/about.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.