API profili i list IP
Metody konfiguracji filtrów i list adresów.
Profile
| Metoda | Ścieżka | Rola |
|---|---|---|
| GET / POST | /v1/orgs/{org}/profiles |
member / admin |
| GET / PUT / DELETE | /v1/orgs/{org}/profiles/{id} |
member / admin / admin |
Profil opisują m.in. name, limbo, level, verifiedTtlSec, verifiedMaxUses, securityChecks, packetOrder, ipList, rateLimit, cps, maxPerIp, version, minVersion, antiVpn i motd.
Najpierw skonfiguruj profil w panelu, a następnie pobierz jego dane jako punkt wyjścia integracji. Parametry zależą od trybu ochrony; błędna kombinacja zwraca validation. Nie kopiuj ustawień profilu zarządzanego do własnego formularza jako edytowalnych.
PUT zastępuje pełną konfigurację. Profil używany przez trasę nie może zostać usunięty (409 in_use). Ograniczenia planu Free obowiązują również przez API (403 plan_restricted).
Listy IP
| Metoda | Ścieżka | Rola |
|---|---|---|
| GET / POST | /v1/orgs/{org}/iplists |
member / admin |
| GET / PUT / DELETE | /v1/orgs/{org}/iplists/{id} |
member / admin / admin |
Przykład obiektu tworzenia lub aktualizacji:
{
"name": "Blokowane adresy",
"entries": [{"cidr": "192.0.2.0/24", "action": "deny"}]
}
To przykładowy zakres dokumentacyjny. Wpis ma cidr i action (allow lub deny). Zapis listy nie przypisuje jej automatycznie do trasy; użyj ipListIds w konfiguracji trasy. Lista używana przez trasę nie może zostać usunięta.