Documentation
Table of Contents
> Objecte de tipus de suport
Els seg¨¹ents objectes s¨®n relacionats amb l'API mediatype.
Tipus de suport
L'objecte de tipus de suport t¨¦ les propietats seg¨¹ents.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| mediatypeid | string | (nom¨¦s lectura) ID del tipus de suport. |
| name (obligatori) |
string | Nom del tipus de suport. |
| type (obligatori) |
integer | Transport emprat pel tipus de suport. Valors possibles: 0 - correu-e; 1 - script; 2 - SMS; 4 - Webhook. |
| exec_path | string | Per als tipus de suport d'script, exec_path cont¨¦ el nom de l'script executat.Requerit per als tipus de suport d'script. |
| gsm_modem | string | Nom del dispositiu s¨¨rie del m¨°dem GSM. Requerit per als tipus de suports SMS. |
| passwd | string | Mot de pas d'autenticaci¨®. S'empra per als tipus de mitjans de correu-e. |
| smtp_email | string | Adre?a de correu-e des de la que s'enviaran les notificacions. Requerit per als tipus de mitjans de correu-e. |
| smtp_helo | string | SMTP HELO. Requerit per als tipus de suports de correu-e. |
| smtp_server | string | Servidor SMTP. Requerit per als tipus de mitjans de correu-e. |
| smtp_port | integer | Port del servidor SMTP per connectar-se. |
| smtp_security | integer | Nivell de seguretat de la connexi¨® SMTP que cal emprar. Valors possibles: 0 - Cap; 1 - STARTTLS; 2 - SSL/TLS. |
| smtp_verify_host | integer | SSL verifica l'equip per a SMTP. Valors possibles: 0 - No; 1 - S¨ª. |
| smtp_verify_peer | integer | SSL verifica el parell per a SMTP. Valors possibles: 0 - No; 1 - S¨ª. |
| smtp_authentication | integer | M¨¨tode d'autenticaci¨® SMTP que cal emprar. Valors possibles: 0 - Cap; 1 - Mot de pas normal. |
| status | integer | Si el tipus de suport ¨¦s habilitat. Valors possibles: 0 - (per defecte) activat; 1 - desactivat. |
| username | integer | Nom d'usuari. S'empra per als tipus de mitjans de correu-e. |
| exec_params | string | Par¨¤metres d'script. Cada par¨¤metre acaba amb un salt de l¨ªnia nova. |
| maxsessions | integer | El nombre m¨¤xim d'alertes que es poden processar en paral¡¤lel. Valors possibles per a SMS: 1 - (per defecte) Valors possibles ??per a altres tipus de suports: 0-100 |
| maxattempts | integer | El nombre m¨¤xim d'intents per enviar una alerta. Valors possibles: 1-100 Per defecte: 3 |
| attempt_interval | string | L'interval de reintent. Accepta segons i unitat de temps amb sufix. Valors possibles: 0-1h Valor per defecte: 10s |
| content_type | integer | Format del missatge. Valors possibles: 0 - text sense format; 1 - (per defecte) html. |
| script | text | Cos de JavaScript de l'script del tipus de suport webhook. |
| timeout | string | Temps d'espera de l'script del tipus de suport Webhook. Accepta segons i unitat de temps amb sufix. Valors possibles: 1-60s Valor per defecte: 30s |
| process_tags | integer | Defineix si la resposta de l'script webhook s'ha d'interpretar com a etiquetes i aquestes etiquetes s'han d'afegir a l'esdeveniment associat. Valors possibles: 0 - (per defecte) Ignora la resposta de l'script webhook. 1 - Tracta la resposta de l'script webhook com a etiquetes. |
| show_event_menu | integer | Mostra l'entrada del tipus de suport a problem.get i event.get a la propietat urls.Valors possibles: 0 - (per defecte) No afegiu l'entrada urls.1 - Afegeix un tipus de suport a la propietat urls. |
| event_menu_url | string | Defineix la propietat url de l'entrada del tipus de suport a la propietat urls de problem.get i event.get. |
| event_menu_name | string | Defineix la propietat name de l'entrada del tipus de suport a la propietat urls de problem.get i event.get. |
| parameters | array | Matriu de par¨¤metres d'entrada del webhook. |
| description | text | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® del tipus de suport. |
Tingueu en compte que per a alguns m¨¨todes (actualitzar, esborrar) la combinaci¨® de par¨¤metres obligatoris/opcionals ¨¦s diferent.
Par¨¤metres Webhook
Els par¨¤metres passats a l'script webhook quan es crida tenen les propietats seg¨¹ents.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| name (obligatori) |
string | Nom del par¨¤metre. |
| value | string | Valor del par¨¤metre. Admet les macros descrites a la p¨¤gina de macros admeses. |
Plantilla de missatge
L'objecte defineix una plantilla que s'emprar¨¤ com a missatge predeterminat per a les operacions d'acci¨® per enviar una notificaci¨®. T¨¦ les seg¨¹ents propietats.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| eventsource (obligatori) |
integer | Font de l'esdeveniment. Valors possibles: 0 - triggers; 1 - descobriment; 2 - enregistrament autom¨¤tic;< br>3 - intern; 4 - serveis. |
| recovery (obligatori) |
integer | Mode d'operaci¨®. Valors possibles: 0 - operacions; 1 - operacions de recuperaci¨®; 2 - operacions d'actualitzaci¨®. |
| subject | string | Assumpte del missatge. |
| message | string | Text del missatge. |