Référence des structures
Voici les structures proposé par Reqwest pour Rust :
| Nom | Description |
|---|---|
| Body | Cette structure représente un corps de requête asynchrone. Elle permet d'envoyer des données sous forme de texte, de bytes, de fichiers ou de flux (Stream). Elle est utilisée pour alimenter une requête HTTP avec du contenu, notamment pour les méthodes POST ou PUT. |
| Client | Cette structure représente un client HTTP asynchrone capable d'envoyer des requêtes vers des serveurs web. Elle réutilise les connexions TCP quand c'est possible, gère les cookies, les redirections, les proxys et la configuration TLS.\ |
| ClientBuilder | Cette structure permet de construire un Client avec une configuration personnalisée. Elle offre des méthodes pour activer les cookies, définir des timeouts, ajouter des proxies, activer TLS ou encore personnaliser les en-têtes par défaut. |
| Error | Cette structure regroupe les erreurs pouvant survenir lors du traitement d'une requête, que ce soit des erreurs réseau, de parsing, de construction d'URL ou de protocole HTTP. Elle implémente std::error::Error pour une gestion idiomatique des erreurs en Rust. |
| Method | Cette structure représente la méthode HTTP (verbe) d'une requête, comme GET, POST, PUT, DELETE, etc. Elle est utilisée pour spécifier l'intention de la requête lors de sa construction. |
| NoProxy | Cette structure permet de configurer une exclusion de proxy pour certains domaines ou adresses IP. Elle filtre les requêtes qui ne doivent pas passer par un proxy, en complément des règles définies par la structure Proxy. |
| Proxy | Cette structure permet de définir les paramètres d'un proxy HTTP que le Client utilisera pour certaines requêtes. Elle accepte des règles conditionnelles, des authentifications et s'intègre à la configuration du Client. |
| Request | Cette structure représente une requête HTTP prête à être envoyée. Elle peut être construite avec RequestBuilder et exécutée via Client::execute(). Elle encapsule les en-têtes, l'URL, la méthode et le corps. |
| RequestBuilder | Cette structure fournit un système de construction progressive (builder pattern) pour une requête HTTP. Elle permet de définir les méthodes, URL, en-têtes, cookies, corps, et autres paramètres avant l'envoi effectif via .send(). |
| Response | Cette structure représente la réponse reçue suite à une requête HTTP. Elle contient le code de statut, les en-têtes, le corps de réponse, et permet de lire ce dernier sous différentes formes (text, json, bytes, etc.). |
| StatusCode | Cette structure encapsule un code de statut HTTP, tel que 200 OK, 404 Not Found, ou 500 Internal Server Error. Elle fournit des utilitaires pour tester le type de réponse (is_success(), is_client_error(), etc.). |
| Upgraded | Cette structure représente une connexion HTTP qui a été surclassée (upgraded), comme dans le cas d'un passage au protocole WebSocket. Elle permet un accès direct au flux TCP après que l'échange initial HTTP est terminé. |
| Url | Cette structure représente une URL HTTP analysée et validée. Elle est utilisée pour définir la cible d'une requête. Elle fournit des méthodes pour construire, analyser ou modifier les composants de l'URL (scheme, host, query, etc.). |
| Version | Cette structure représente la version du protocole HTTP, comme HTTP/1.1 ou HTTP/2. Elle est utilisée pour indiquer la version du protocole dans les requêtes ou les réponses. |
Dernière mise à jour : Samedi, le 4 janvier 2025