---
title: "www"
slug: "api-v1-system-www"
updated: 2024-10-25T10:25:40Z
published: 2024-10-25T10:25:40Z
canonical: "docs.fmad.io/api-v1-system-www"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fmad.io/llms.txt
> Use this file to discover all available pages before exploring further.

# www

Provides API access to replace the default WWW certificate

## /api/v1/system/www/cert/get

Gets the current WWW TLS certificate

#### Address

`/api/v1/system/www/cert/get`

#### Verb

GET

#### Privilege

ADMIN only

#### Notes

By default a self signed fmadio certificate is installed.

#### Arguments

| Parameter | Description |
| --- | --- |
| PublicKey=true | Returns the public key |
| PrivateKey=true | Returns the private key |

### Example

Example to fetch the current public default key

```bash
fmadio@fmadio100v2-228U:~$ curl -u fmadio:***** -k https://192.168.2.175/api/v1/system/www/cert/get?PublicKey=true
-----BEGIN CERTIFICATE-----
MIID8jCCAtqgAwIBAgIUCxyi5ZZLOKkFRMLjtQCOBTtBbPswDQYJKoZIhvcNAQEL
BQAwgYExCzAJBgNVBAYTAlNHMRIwEAYDVQQIDAlTaW5nYXBvcmUxEjAQBgNVBAcM
CVNpbmdhcG9yZTEZMBcGA1UECgwQZm1hZCBlbmdpbmVlcmluZzEPMA0GA1UEAwwG
Zm1hZGlvMR4wHAYJKoZIhvcNAQkBFg9zdXBwb3J0QGZtYWQuaW8wHhcNMjMwNTE5
MDY0MjMwWhcNMjgwNTE3MDY0MjMwWjCBgTELMAkGA1UEBhMCU0cxEjAQBgNVBAgM
CVNpbmdhcG9yZTESMBAGA1UEBwwJU2luZ2Fwb3JlMRkwFwYDVQQKDBBmbWFkIGVu
Z2luZWVyaW5nMQ8wDQYDVQQDDAZmbWFkaW8xHjAcBgkqhkiG9w0BCQEWD3N1cHBv
cnRAZm1hZC5pbzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJNuB0G9
tQfzX9ZTmpKJGBQrgjn3uNzfuIalTrL9tyPdjB4i8tb10aDvwird3r7hYM8yK8Du
Pp05rfp24lLadQkpLGqOeWFel9W8OSKNJ8MSVTPyMqnCu0uw9m849yZOZndnRX9b
Ydo07wD4D+dlqwx+rkOnBWKJ3VkQKzSIqDRn/LS74LpZpbuAFta1jA3+iUhKnpCh
lIu3HAyAY8g4a4LBDPi2uQ4enbGcfs3j4b39d0em/JoNobyfSU1gFxEeuHJzdzve
c35RmEEEA4JROJE7NdF43BzVEPDcIgV+pglwOKOg+YKATPuEQ+KBPQBRk8jAF4Rd
XkCg6sFWpfqD6hcCAwEAAaNgMF4wHQYDVR0OBBYEFMQxrrBpv153z7kGl7mWurcE
iNTTMB8GA1UdIwQYMBaAFMQxrrBpv153z7kGl7mWurcEiNTTMAwGA1UdEwQFMAMB
Af8wDgYDVR0PAQH/BAQDAgPoMA0GCSqGSIb3DQEBCwUAA4IBAQASdyqBocta8On+
RE1AYP6xYBXCni922qkuO7NxOAQXK2O4sJ2zXKkeA1n1+1oJmzSjf7hnCv/BAxfI
z/e3xxMbnZB3IVoZOd3WrlIqRo0yJTrUucx+urUL7rDkohOcuSI9lRdJZvaq0Sri
0nt/Rem/cmDIQ0YL098Dxysz1Y4rnBuAnvJ4ZXDOVJwbufi0BtStlxDwbBj72ZpT
S7fBFUd2yvht1uJCIOa6VuqlZoAoKiLeYiOSl8c5MfIWTo8dT5sCazCrQn7JbxQ6
3caQuQ8TFmMyJ3oHtQrjdtlnoQbxAh3VPDqXZgbKCi7SsiWgUybNo4la1J1hka5u
AW8NTxTL
-----END CERTIFICATE-----
fmadio@fmadio100v2-228U:~$
```

## /api/v1/system/www/cert/put

Sets a custom WWW TLS certificate

#### Address

`/api/v1/system/www/cert/put`

#### Verb

POST

#### Privilege

ADMIN only

#### Notes

The new TLS certificate is not active untill `/api/v1/system/www/restart` has been called.

#### Arguments

| Parameter | Description |
| --- | --- |
| PublicKey=true | Writes the public key |
| PrivateKey=true | Writes the private key |

### Example

Example to POST a new TLS Public key

```bash
fmadio@fmadio100v2-228U:/mnt/store0/etc$ curl -s -X POST -u fmadio:**** "http://192.168.2.175/api/v1/system/www/cert/put?PublicKey=true" -H "Content-Type: multipart/form-data" -F "data=@./fmadio_cert.pem"  | jq
{
  "Status": true
}
fmadio@fmadio100v2-228U:/mnt/store0/etc$
```

## /api/v1/system/www/restart

Restarts the WWW process with a new configuration

#### Address

`/api/v1/system/www/restart`

#### Verb

GET

#### Privilege

ADMIN only

#### Notes

As this restarts the WWW processes it will not return any value

#### Arguments

| Parameter | Description |
| --- | --- |
|  |  |

### Example

Example to Restat the WWW process

It may take up to 60sec for the restart process to complete

```bash
fmadio@fmadio100v2-228U:/mnt/store0/etc$ curl -u fmadio:***** -k https://192.168.2.175/api/v1/system/www/restart
curl: (52) Empty reply from server
fmadio@fmadio100v2-228U:/mnt/store0/etc$
```