Ghid rapid API cloud

Provizionează programatic o mașină virtuală cloud în câteva minute. Potrivită pentru automatizări cu Terraform, resurse CI/CD temporare și capacitate dinamică.

1. Obține un token

Autentifică-te, deschide Dashboard-ul și creează un token API din setările contului. Setează PIDGINHOST_API_TOKEN ca variabilă de mediu.

2. Listează pachetele de server disponibile

curl -X GET https://www.pidginhost.com/api/v1/cloud/server-packages/ \
  -H "Authorization: Token $PIDGINHOST_API_TOKEN"

3. Creează o VM

curl -X POST https://www.pidginhost.com/api/v1/cloud/servers/ \
  -H "Authorization: Token $PIDGINHOST_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "hostname": "web-01",
    "package": "cloudv-4",
    "image": "ubuntu24",
    "ssh_pub_key": "ssh-ed25519 AAAA..."
  }'

Răspunsul include ID-ul noului server. Interoghează endpoint-ul de detalii până când starea devine active.

4. Același flux cu CLI-ul phctl

phctl auth login --token "$PIDGINHOST_API_TOKEN"
phctl compute server create \
  --hostname web-01 \
  --package cloudv-4 \
  --image ubuntu24

Ai nevoie de referința completă?

Fiecare endpoint cu exemple Python, JavaScript, PHP, Go, Rust, CLI și curl.

Deschide documentația API completă OpenAPI / Swagger UI Documentația serviciilor

Gata să lansezi infrastructura?

Creezi contul în câteva minute. Planul cloud gratuit include un server per client după depuneri confirmate în cont de cel puțin 10 €. Eligibilitatea pentru returnarea banilor diferă în funcție de serviciu.

Creează-ți contul sau vorbește cu echipa noastră