Documentazione per sviluppatori

Modello mentale

1. ScenarioUn Ping, un Flow o una Chain, creato nella console, tramite l’API o Terraform.
2. EsecuzionePathly lo riproduce dall’Europa, a intervalli o su richiesta dalla CI.
3. IncidenteUn errore confermato apre un incidente, con lo screenshot del passaggio.
4. WebhookIl Suo sistema riceve l’evento firmato con HMAC.

Quickstart in 5 minuti

Obiettivo: una chiave, un Ping, un webhook di test, un riferimento Terraform. Conti cinque minuti se l’account Solo esiste già. Una Chain si crea poi con httpChain (API) o http_chain (provider).

1) Apra la Console Pathly (crei un account gratuito dal link qui sotto) → Impostazioni → Chiavi API → emetta una chiave con scenarios:write e alerting:write. Copi il segreto una sola volta (prefisso sp_). 2) Esporti PATHLY_API_TOKEN. 3) Crei lo scenario (esempio qui sotto). 4) Crei un webhook verso un ricevitore di test (webhook.site o il Suo /hooks). 5) Provider Terraform pathlyhq/pathly per versionare il resto.

• Creare un account gratuito → ottenere una chiave API

export PATHLY_API_TOKEN=sp_…

curl -sS https://api.pathlyhq.com/v1/scenarios \
  -H "Authorization: Bearer $PATHLY_API_TOKEN" | jq .

curl -sS -X POST https://api.pathlyhq.com/v1/scenarios \
  -H "Authorization: Bearer $PATHLY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: qs-$(date +%Y%m%d)-home" \
  -d '{
    "type": "http",
    "name": "Home",
    "url": "https://www.example.com/",
    "intervalSec": 300,
    "expectedStatus": 200
  }'

curl -sS -X POST https://api.pathlyhq.com/v1/webhooks \
  -H "Authorization: Bearer $PATHLY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: qs-hook-1" \
  -d '{
    "url": "https://www.example.com/hooks/pathly",
    "events": ["run.failed", "run.recovered"]
  }'

terraform {
  required_providers {
    pathly = { source = "pathlyhq/pathly", version = "~> 0.1" }
  }
}
provider "pathly" {}
# PATHLY_API_TOKEN in the CI / shell environment, never in .tf files

Pagine della documentazione