Black Friday tra 20 giorni: i Suoi clienti potranno pagare? -25 % il 1° anno e configurazione offerta, fino al 30 novembreVedi l’offerta →

PathlyAnalizza il mio sito

Integrazione

Ping, Flow, Chain — run, incidenti e SLA

Ping, Flow o Chain, avvio dei run, manutenzione e obiettivi di disponibilità.

Ottenere la mia chiave APIContratto OpenAPI

Documento completo, senza autenticazione, da passare al Suo generatore di client.

Ping e Chain

type: "http" richiede `url` (Ping) o `httpChain` (Chain, 1–10 hop). Controlli: expectedStatus, expectText, intestazioni, JSONPath, tempi, TLS / DNS. intervalSec fissa la cadenza. enabled: false prepara senza avvisare. Body e intestazioni degli hop non tornano mai in lettura.

POST minimal

curl -X POST https://api.pathlyhq.com/v1/scenarios \
  -H "Authorization: Bearer $PATHLY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: http-home-v1" \
  -d '{
    "type": "http",
    "name": "Home",
    "url": "https://www.example.com/",
    "intervalSec": 300,
    "expectedStatus": 200,
    "severity": "critical"
  }'

POST Chain — login poi /me

curl -X POST https://api.pathlyhq.com/v1/scenarios \
  -H "Authorization: Bearer $PATHLY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: chain-me-v1" \
  -d '{
    "type": "http",
    "name": "Login then /me",
    "intervalSec": 300,
    "httpChain": [
      {
        "name": "Login",
        "method": "POST",
        "url": "https://api.example.com/login",
        "body": "{"email":"[email protected]"}",
        "assertStatus": 200,
        "extractJson": { "path": "token", "as": "token" }
      },
      {
        "name": "Me",
        "method": "GET",
        "url": "https://api.example.com/me",
        "assertStatus": 200
      }
    ]
  }'

PATCH — pausa

curl -X PATCH https://api.pathlyhq.com/v1/scenarios/{id} \
  -H "Authorization: Bearer $PATHLY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

PowerShell

$headers = @{ Authorization = "Bearer $env:PATHLY_API_TOKEN" }
Invoke-RestMethod -Method Get -Uri "https://api.pathlyhq.com/v1/scenarios" -Headers $headers

Flow

type: "browser" richiede un AST di passaggi. Crei il percorso nella console (registratore): login, carrello, 2FA. L’API può farvi riferimento e avviarlo, ma non deve trasportare le credenziali dei clienti in Git.

In lettura ottiene un’impronta dello scenario, non il dettaglio dei segreti. La usi per rilevare una modifica fuori banda (console contro Terraform).

Run (esecuzioni)

Un run è un’esecuzione fatturata. GET /v1/runs elenca la cronologia. Il POST di avvio (runs:trigger) lancia uno smoke immediato, utile in CI post-deploy. Tenga d’occhio la quota del piano: il rate limit dell’API e la quota commerciale sono distinti.

Elenco recente

curl "https://api.pathlyhq.com/v1/runs?limit=20" \
  -H "Authorization: Bearer $PATHLY_API_TOKEN"

Avviare (se disponibile nel Suo piano / ambito)

curl -X POST https://api.pathlyhq.com/v1/scenarios/{id}/runs \
  -H "Authorization: Bearer $PATHLY_API_TOKEN" \
  -H "Idempotency-Key: smoke-$(git rev-parse --short HEAD)"

Incidenti

Gli incidenti raggruppano errori consecutivi secondo la politica di escalation. Lettura: incidents:read. Scrittura (presa in carico / note secondo il contratto): incidents:write. Un identificativo sconosciuto → 404.

curl "https://api.pathlyhq.com/v1/incidents?limit=50" \
  -H "Authorization: Bearer $PATHLY_API_TOKEN"

Manutenzione e SLA

Finestre di manutenzione: silenziano gli avvisi durante una fascia pianificata (deploy). Obiettivi di disponibilità (SLA): soglia e perimetro, avvisi quando il budget di errore si esaurisce. Entrambi sono risorse IaC di primo piano.

Terraform — maintenance + SLA

resource "pathly_maintenance_window" "friday_deploy" {
  name       = "Friday deploy"
  starts_at  = "2026-09-26T22:00:00Z"
  ends_at    = "2026-09-26T23:00:00Z"
  # lier les scénarios concernés selon le schéma provider
}

resource "pathly_sla_target" "checkout" {
  name              = "Checkout"
  target_percentage = 99.9
}