| Scroll Ignore | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
Concept
- La météo peut avoir le nom d'une météo déjà existante.
- L'API retourne l'UUID de la vue
- Création d'une vue uniquement : Pas de contenu à la création
Les paramètres
Méthode POST permettant de créer une nouvelle vue météo.
| Info |
|---|
La vue créée sera forcément vide à sa création ( widget Titre uniquement ). |
Les paramètres
Les paramètres doivent être envoyées au format JSON dans le corps de la requête.
| Nom et format | Valeur par défaut | Description |
|---|---|---|
"weather_name": "Ma vue météo" | --- | Nom de la vue météo. |
Réponse
Codes de retour
| Codes de retour | Explications |
|---|---|
| 200 | OK |
| 400 | Paramètre invalide |
| 401 | L'accès nécessite une authentification ou un Token valide. |
| 403 | Authentification de l'utilisateur OK, mais droits non suffisants. |
| 500 | L'appel est valide, mais un problème d'exécution est rencontré. |
Retour du code 200
Retour du code 400
- Mêmes erreurs que dans l'interface ( dans la langue de l'interface )
- Même comportement que l'interface : On peut sauvegarder la vue si l'interface l'aurait autorisé.
- Code d'erreur HTTP cohérent
Paramètres POST incorrects
| Code Block | ||||
|---|---|---|---|---|
| ||||
curl -s -S -U 'username:password' -X POST \
-H 'Content-Type: application/json' -d '{"weather_name": "Ma vue météo"}' \
"http://webui:7767/external-api/service-weather/v1/create" |
Exemple de sortie attendue :
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"output": {
"view_info": {
"name": "Ma vue météo",
"state": "draft",
"type": "service_weather",
"weather_uuid": "4bdd306edbad4f6dbc10db2fcc7662a4",
"weather_version": 1,
"weather_format_version": 5,
"weather_shared_group": "service_weather",
"weather_creation_time": 1787820376.9576776
}
}
} |
Retour du code 400
Paramètres POST incorrects
JSON invalide
| Code Block | ||||
|---|---|---|---|---|
| ||||
curl -s -S -U 'username:password' -X POST \
-H 'Content-Type: application/json' -d '[]' \
"http://webui:7767/external-api/service-weather/v1/create" |
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"output": "Invalid JSON"
} |
Paramètre inconnu
| Code Block | ||||
|---|---|---|---|---|
| ||||
curl -s -S -U 'username:password' -X POST \
-H 'Content-Type: application/json' -d '{"unknown_key": "value"}' \
"http://webui:7767/external-api/service-weather/v1/create" |
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"output": "Invalid field name [ unknown_key ]"
} |
Messages d'erreurs des filtres
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|
...