Ottenere la chiave#

Ottieni il token di autenticazione nelle impostazioni utente, quindi copia la chiave generata per l’accesso all’API.

Impostazioni chiave API

Chiave API

Specifiche#

Base URL: https://api.privateflare.com

Autenticazione: Includi l’intestazione X-Auth-Key con il valore del tuo token API.

Metodi disponibili#

Metodo Endpoint Descrizione
GET /me Informazioni sull’utente
GET /domains/ Elenco dei domini
GET /domains/{domain} Dettagli di un dominio specifico
POST /domains/ Creazione di un nuovo dominio
PATCH /domains/{domain} Aggiornamento dei parametri del dominio
DELETE /domains/{domain} Eliminazione del dominio
GET /domains/{domain}/uptime Statistiche del tempo di risposta del server
GET /tasks/ Attività attive di generazione certificati
GET /security/iplist/ Inventario delle liste IP
POST /security/iplist/ Creazione di una lista IP
PATCH /security/iplist/{listid} Aggiornamento di una lista IP
DELETE /security/iplist/{listid} Eliminazione di una lista IP
PUT /security/iplist/{listid}/{ip} Aggiunta di un IP alla blocklist
DELETE /security/iplist/{listid}/{ip} Rimozione di un IP dalla blocklist
GET /nodes/ Elenco dei node

Esempi di richieste#

Informazioni sull’utente#

curl --location 'https://api.privateflare.com/me/' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx'

Elenco dei domini#

curl --location 'https://api.privateflare.com/domains/' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx'

Ottenere un dominio specifico#

curl --location 'https://api.privateflare.com/domains/domain.com' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx'

Creazione di un dominio#

curl --location 'https://api.privateflare.com/domains/' \
--header 'Content-Type: application/json' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx' \
--data '{
    "enabled": true,
    "domain": "domain.com",
    "mask": "yandex.info",
    "ssl": true,
    "tags": ["tag1","tag2"],
    "backend": "127.0.0.1",
    "fhttps": true,
    "cachelevel": 1
}'

Modifica di un dominio#

curl --location 'https://api.privateflare.com/domains/domain.com' \
--header 'Content-Type: application/json' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx' \
--data '{
    "enabled": true
}'

È possibile inviare SOLO i parametri da MODIFICARE.

Eliminazione di un dominio#

curl --location --request DELETE 'https://api.privateflare.com/domains/domain.com' \
--header 'Content-Type: application/json' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx'

Creazione di una blocklist IP#

curl --location 'https://api.privateflare.com/security/iplist/' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
    "name": "list name",
    "ips": ["1.1.1.1"],
    "allnodes": true,
    "nodes": []
}'

Aggiunta di un IP alla blocklist#

curl --location --request PUT 'https://api.privateflare.com/security/iplist/6/2.2.2.2' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx'

Rimozione di un IP dalla blocklist#

curl --location --request DELETE 'https://api.privateflare.com/security/iplist/6/2.2.2.2' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx'