# Escribir un script personalizado usando Python

Necesitas conocimientos prácticos de:

- JSON
- Python

## Estructura del archivo de script personalizado

1. Importar los paquetes requeridos
2. Obtener los argumentos de entrada
3. Implementar la lógica
4. Devolver JSON

## Paquetes de uso frecuente

| Paquete | Uso |
|---|---|
| Sys | Obtiene los argumentos de entrada |
| json | Manipula datos JSON |
| requests | Realiza llamadas a la API |
| datetime | Transforma el tiempo de milisegundos al formato de fecha requerido |

## Obtener argumentos de entrada

Los argumentos del archivo de script se pueden obtener usando `sys.argv[index]`, donde `index` comienza desde 1 hasta el número de argumentos pasados.

Cuando el argumento pasado es `$COMPLETE_V3_JSON_FILE` (la ruta al archivo que contiene el JSON de la solicitud), el archivo JSON se puede leer usando el siguiente fragmento:

```python
file_Path = sys.argv[1]
with open(file_Path) as data_file:
    data = json.load(data_file)
```

## Implementar la lógica

Fragmento para hacer una llamada a la API:

```python
with requests.Session() as s:
    url = 'api_url'
    r = s.post(url, verify=True, data=post_data, headers=headers)
```

Construye `api_url`, `post_data` y `headers` según sea necesario.

Fragmento para transformar el tiempo de milisegundos al formato de fecha requerido:

```python
date = datetime.datetime.fromtimestamp(int(millisec)/1e3).strftime('%d %b %Y, %H:%M:%S')
```

## Construir el JSON de retorno

Construcción de un JSON de ejemplo como `{"key":"value"}`:

```python
json = {}
json["key"] = "value"
print(json)
```

Construcción de un arreglo JSON de ejemplo como `[{"key":"value"}]`:

```python
json = {}
json["key"] = "value"
result = []
result.append(json)
print(result)
```

***<<Scripts de ejemplo>>***