Dla deweloperów
Hosting, którym może sterować Twoja automatyzacja
Każde konto Aderlo Cloud może utworzyć własne klucze API o ograniczonym zakresie i być sterowane z zewnątrz — z n8n, z pipeline'ów CI, ze zwykłych skryptów albo z agenta AI. 117 poleceń obejmuje domeny, DNS, pocztę, bazy danych, FTP, SSL, kopie zapasowe i statystyki zużycia. Większość hostingów współdzielonych na tym rynku daje dostęp do API wyłącznie resellerom albo wcale.
Tworzenie klucza API
Panel → Advanced Features → Login Keys → Create. Liczą się cztery ustawienia:
| Ustawienie | Zalecenie |
|---|---|
| Allow Commands | Tylko to, czego integracja naprawdę potrzebuje. Klucz dla n8n, które zarządza DNS-em, nie ma po co czytać Twojej poczty. |
| Allow Networks | Adres IP maszyny, która wywołuje API — Twojego serwera n8n, Twojego runnera CI. Z każdego innego miejsca klucz przestaje działać. |
| Allow Login | Wyłącz. Kluczem tylko do API nie da się zalogować do panelu, nawet jeśli wycieknie. |
| Expiry | Ustaw ją przy dostępie tymczasowym — agencja robiąca jednorazową migrację nie potrzebuje klucza, który przeżyje projekt. |
Nazwa klucza musi być alfanumeryczna — myślniki i podkreślenia panel odrzuca.
Uwierzytelnianie
HTTP Basic: nazwa użytkownika to nazwa Twojego konta hostingowego, hasło to klucz API. Dodaj json=yes, żeby dostawać odpowiedzi w JSON zamiast zakodowanych w URL-u.
BASE="https://web01.aderlo.cloud:2222"
AUTH="youraccount:YOUR_API_KEY"Przykłady
Każdy z tych przykładów wykonaliśmy na prawdziwym koncie klienta i zwrócił dokładnie taką odpowiedź, jaką tu widzisz.
Wypisanie Twoich domen
curl -u "$AUTH" "$BASE/CMD_API_SHOW_DOMAINS?json=yes"
# ["yourstore.pl"]Zużycie konta — do monitoringu i alertów
curl -u "$AUTH" "$BASE/CMD_API_SHOW_USER_USAGE?json=yes"
# {"bandwidth":"0.0","domainptr":"0","email_deliveries":"0", ...}Odczyt i zmiana DNS
# read the zone
curl -u "$AUTH" "$BASE/CMD_API_DNS_CONTROL?domain=yourstore.pl&json=yes"
# add an A record
curl -u "$AUTH" "$BASE/CMD_API_DNS_CONTROL" \
-d domain=yourstore.pl -d action=add -d type=A -d name=api -d value=1.2.3.4Utworzenie skrzynki pocztowej
curl -u "$AUTH" "$BASE/CMD_API_EMAIL_POP" \
-d action=create -d domain=yourstore.pl -d user=contact \
-d passwd=... -d passwd2=... -d quota=1024Wypisanie baz danych
curl -u "$AUTH" "$BASE/CMD_API_DATABASES?json=yes"Sterowanie z n8n
Nie potrzebujesz dedykowanego node'a — standardowy node HTTP Request robi wszystko:
| Method | GET or POST |
| URL | https://web01.aderlo.cloud:2222/CMD_API_… |
| Authentication | Generic → Basic Auth |
| User / Password | nazwa konta / klucz API — trzymane w n8n Credentials |
| Query / Body | parametry polecenia plus json=yes |
Trzymaj klucz w n8n Credentials, nigdy na sztywno w node'zie — inaczej wyląduje w każdym eksporcie workflow i w historii Twojego repozytorium.
Dwie pułapki, o których warto wiedzieć
error=0 nie zawsze znaczy, że się udało
Widzieliśmy operacje usuwania, które odpowiadają error=0, nie usuwając niczego. Po każdym wywołaniu zmieniającym stan zrób osobny odczyt i sprawdź wynik — w n8n to jeden node więcej i naprawdę warto.
Komunikaty w odpowiedziach są tłumaczone — czytaj pola, nie tekst
Odpowiedzi są zakodowane w URL-u, a komunikaty pisane dla ludzi przychodzą w języku panelu danego konta. Automatyzacja musi sprawdzać pole error, nigdy treść komunikatu.
WP-CLI przez SSH
Każdy pakiet zawiera jailed SSH z WP-CLI 2.12 — narzędziem, którym agencje skryptują WordPressa naraz w wielu sklepach:
wp plugin update --all
wp core update
wp db export backup.sql
wp search-replace 'staging.yourstore.pl' 'yourstore.pl'Pełną listę 117 poleceń zobaczysz w panelu podczas tworzenia klucza, pogrupowaną obszarami — domeny, poczta, DNS, bazy danych, pliki, FTP, SSL, cron i statystyki. Zaznacz tylko to, czego potrzebuje Twoja integracja; kolejny klucz zawsze możesz utworzyć później.