# weboptions

Spécifier les paramètres pour les services web RESTful

## 📝 Syntaxe

* options = weboptions()
* options = weboptions(name, value)

## 📥 Argument d'entrée

* name - chaîne.
* value - valeur correspondant au champ name.

## 📤 Argument de sortie

* options - objet weboptions.

## 📄 Description

options = weboptions() renvoie l'objet weboptions par défaut.

Un objet weboptions peut être un argument optionnel pour les fonctions builtin webread, websave et webwrite.

Arguments Nom-Valeur :

UserAgent Identification de l'agent utilisateur : chaîne ou vecteur de caractères.

Timeout Durée du timeout de connexion : scalaire numérique positif ou valeur Inf.

Username Identifiant utilisateur : chaîne ou vecteur de caractères.

Password Mot de passe d'authentification : chaîne ou vecteur de caractères.

KeyName Nom de la clé : chaîne ou vecteur de caractères.

KeyValue Valeur de la clé : chaîne, vecteur de caractères, numérique ou logique.

HeaderFields Noms et valeurs des en-têtes : tableau m-by-2 de chaînes ou cellule de vecteurs de caractères.

ContentType Type de contenu : chaîne. Valeurs supportées : 'auto', 'text', 'audio', 'binary', 'json', 'raw'.

ContentReader Lecteur de contenu : handle de fonction.

MediaType Type média : chaîne. Valeurs supportées : 'auto', 'application/x-www-form-urlencoded'.

RequestMethod Méthode HTTP : chaîne. Valeurs supportées : 'auto', 'get', 'post', 'put', 'delete', 'patch'.

ArrayFormat : 'csv' (par défaut), 'json', 'repeating' ou 'php'.

CertificateFilename Nom de fichier des certificats racine : chaîne.

FollowLocation indique à la bibliothèque de suivre les redirections Location: envoyées par un serveur HTTP dans une réponse 30x : logique, false par défaut.

## 💡 Exemple

```matlab
weboptions()
options = weboptions('UserAgent', 'http://www.whoishostingthis.com/tools/user-agent/')
```

## 🔗 Voir aussi

[webread](https://nelson-9.gitbook.io/nelson/markdown/fr/webtools/webread), [websave](https://nelson-9.gitbook.io/nelson/markdown/fr/webtools/websave).

## 🕔 Historique

| Version | 📄 Description                  |
| ------- | ------------------------------- |
| 1.0.0   | version initiale                |
| 1.6.0   | option 'FollowLocation' ajoutée |
