Ένα πρόγραμμα μπορεί να ανοίξει λογαριασμό στο PingWise χωρίς άνθρωπο στη διαδικασία: μία κλήση επιστρέφει ένα κλειδί API και έναν σύνδεσμο claim. Ο λογαριασμός είναι unclaimed μέχρι να ανοίξει κάποιος τον σύνδεσμο· όσο είναι unclaimed είναι μικρός, παρακολουθεί μόνο domains που έχει αποδείξει ότι ελέγχει, και διαγράφεται μετά από 72 ώρες. Μόλις γίνει claim, είναι ένας κανονικός λογαριασμός.
Η σελίδα αυτή απευθύνεται στον agent. Αν είστε ο άνθρωπος που έλαβε τον σύνδεσμο claim, ανοίξτε τον, πληκτρολογήστε το email σας, αποδεχθείτε τους Όρους, και ο λογαριασμός είναι δικός σας.
Αντιγράψτε αυτό στον agent σας
Επικολλήστε το παρακάτω κείμενο σε έναν agent που μπορεί να εκτελεί εντολές ή να κάνει αιτήματα HTTP (Claude Code, Cursor, Codex, ChatGPT σε agent mode). Ένας βοηθός chat χωρίς εργαλεία θα εξηγήσει μόνο τα βήματα. Το prompt είναι στα αγγλικά, όπως και το API.
Set up uptime monitoring for my website with PingWise (https://pingwise.com).
1. Register an account for me: POST https://app.pingwise.com/api/v1/agent/register, body {"name": "<my site name>"}. Save the api_key from the answer (it is shown only once) and use it as "Authorization: Bearer <api_key>" on every later request. Show me the claim_url and the expires_at time from the answer.
2. Prove I control my domain: POST https://app.pingwise.com/api/v1/domains {"name": "<my domain>"}. Tell me the TXT record (name and value) to add in my DNS, or the file to put on my site, and wait for me to say it's done. Then call POST https://app.pingwise.com/api/v1/domains/<my domain>/verify until "verified" is true (DNS can take a few minutes).
3. Add up to 5 monitors on that domain, every 60 seconds or slower: POST https://app.pingwise.com/api/v1/monitors {"type": "http", "url": "https://<my domain>/", "interval": 60}. Ask me which pages or services matter if you're not sure.
4. If I give you a webhook URL on the same domain, add it for alerts: POST https://app.pingwise.com/api/v1/channels {"kind": "webhook", "url": "<my webhook URL>"}.
Rules: only act on confirmed outages (incidents), never on a single failed check. Full API: https://app.pingwise.com/api/v1/openapi.json
When you're done, remind me to open the claim_url within 72 hours, or the account and its monitors are deleted.
Με μια ματιά
# 1. Εγγραφή (χωρίς κλειδί). Κρατήστε το api_key: εμφανίζεται μία φορά.
curl -X POST https://app.pingwise.com/api/v1/agent/register \
-H "Content-Type: application/json" -d '{"name": "shop.example.com"}'
# 2. Προσθήκη του domain και ανάγνωση της εγγραφής TXT (ή του αρχείου) που το αποδεικνύει
curl -X POST https://app.pingwise.com/api/v1/domains \
-H "Authorization: Bearer pw_..." -H "Content-Type: application/json" -d '{"name": "example.com"}'
# 3. Βάλτε την εγγραφή ή το αρχείο στη θέση του και ζητήστε έλεγχο
curl -X POST https://app.pingwise.com/api/v1/domains/example.com/verify -H "Authorization: Bearer pw_..."
# 4. Προσθήκη monitor και webhook σε αυτό το domain
curl -X POST https://app.pingwise.com/api/v1/monitors -H "Authorization: Bearer pw_..." \
-H "Content-Type: application/json" -d '{"type": "http", "url": "https://shop.example.com/", "interval": 60}'
curl -X POST https://app.pingwise.com/api/v1/channels -H "Authorization: Bearer pw_..." \
-H "Content-Type: application/json" -d '{"kind": "webhook", "url": "https://shop.example.com/hooks/pingwise"}'
# 5. Δώστε το claim_url στον υπεύθυνο άνθρωπο.
Εγγραφή
Το POST /api/v1/agent/register δέχεται ένα προαιρετικό name και δεν χρειάζεται κλειδί. Η απάντηση περιέχει:
api_key, εμφανίζεται μία φορά· έχει δικαίωμα εγγραφής μέσα στα παρακάτω όρια·claim_url, τον σύνδεσμο που ανοίγει ένας άνθρωπος για να αναλάβει τον λογαριασμό·expires_at, 72 ώρες μετά την εγγραφή·limits: 5 monitors, 60 δευτερόλεπτα ως ταχύτερο διάστημα, 21.600 αρχικά credits, 72 ώρες·terms: τη φράση «By using this key, whoever operates this client accepts the Terms of Service, the Acceptable Use Policy and the Privacy Policy.» και συνδέσμους προς τα τρία κείμενα·next_steps, με λόγια.
Κάθε επόμενη απάντηση φέρει την κεφαλίδα PingWise-Account-Expires, και το GET /api/v1/account έχει ένα μπλοκ unclaimed με τη λήξη και τα όρια.
Η εγγραφή περιορίζεται σε 5 την ώρα ανά διεύθυνση και 20 την ημέρα ανά /24 ή /48, και σε 500 unclaimed λογαριασμούς ταυτόχρονα. Πάνω από ένα όριο η απάντηση είναι 429 με Retry-After και τον λόγο. Το επανειλημμένο άνοιγμα λογαριασμών για να παραταθούν οι 72 ώρες ή να παρακαμφθούν τα όρια αντιβαίνει στην Πολιτική Αποδεκτής Χρήσης.
Απόδειξη domain
Ένας unclaimed λογαριασμός μπορεί να παρακολουθεί μόνο hosts σε domain που έχει επαληθεύσει. Το POST /api/v1/domains με το κύριο domain επιστρέφει την απόδειξη που χρειάζεστε, και με τους δύο τρόπους:
txt: μια εγγραφή DNS με όνομα_pingwise.<domain>και τιμήpingwise-verify=<token>·file:https://<domain>/.well-known/pingwise-verify.txtπου περιέχει το token.
Βάλτε το ένα από τα δύο στη θέση του και καλέστε POST /api/v1/domains/<domain>/verify. Η απάντηση λέει αν πέτυχε και, αν όχι, τι έλειπε. Monitor σε host του οποίου το domain δεν έχει επαληθευτεί απορρίπτεται με 422. Τα παλαιότερα ονόματα, _uptimebox.<domain> και uptimebox-verify.txt, εξακολουθούν να επαληθεύουν. Λεπτομέρειες: Επαλήθευση domain.
Τι μπορεί να κάνει ένας unclaimed λογαριασμός
- Monitors: έως 5, ανά 60 δευτερόλεπτα ή αραιότερα, μόνο σε επαληθευμένα domains: HTTP(S), λέξη-κλειδί, TLS, ping, TCP, SMTP, DNS και οι υπόλοιποι έλεγχοι από τα probes.
- Credits: 21.600 μία φορά, αρκετά για 5 monitors κάθε λεπτό επί 72 ώρες. Χωρίς μηνιαία δωρεάν credits και χωρίς αγορές μέχρι να γίνει claim από άνθρωπο.
- Ειδοποιήσεις: μόνο webhooks, και μόνο σε URL σε επαληθευμένο domain του λογαριασμού, ή σε status page του λογαριασμού. Το
POST /api/v1/channelsεπιστρέφει τοsigning_secretμία φορά· κάθε παράδοση είναι υπογεγραμμένη, βλ. Webhooks. Χωρίς email, SMS ή κανάλια chat. - Status pages: επιτρέπονται, χωρίς συνδρομητές email και χωρίς δικό τους domain μέχρι το claim.
- Λήξη: 72 ώρες μετά την εγγραφή ο λογαριασμός και ό,τι περιέχει διαγράφονται, χωρίς προειδοποιητικό email, αφού δεν υπάρχει κανείς να το λάβει. Η λήξη υπάρχει σε κάθε απάντηση· λάβετέ την υπόψη.
Claim
Ο άνθρωπος ανοίγει το claim_url, πληκτρολογεί ένα email, τσεκάρει το κουτάκι των Όρων και λαμβάνει σύνδεσμο σύνδεσης. Με την πρώτη σύνδεση γίνεται ιδιοκτήτης του ίδιου λογαριασμού, ο οποίος γίνεται κανονικός: τα δωρεάν credits του μήνα, κάθε είδος καναλιού, αγορές, το panel. Τίποτα από όσα έστησε ο agent δεν χάνεται. Ο σύνδεσμος claim είναι το ίδιο μυστικός με το κλειδί: δώστε τον μόνο στον υπεύθυνο άνθρωπο.
Ενεργήστε μόνο σε επιβεβαιωμένες διακοπές
Το PingWise δηλώνει ένα site εκτός λειτουργίας μόνο όταν τα δύο τρίτα των probes που το έλεγξαν, σε τουλάχιστον τρεις ηπείρους και τρία δίκτυα, συμφωνήσουν δύο συνεχόμενες φορές. Ένας agent που αντιδρά σε ειδοποιήσεις, με rollback ενός deploy ή με δημοσίευση περιστατικού, πρέπει να αντιδρά στο monitor.down και σε τίποτα νωρίτερα. Κάθε περιστατικό στο API και κάθε webhook φέρει ένα μπλοκ quorum: πόσα probes συμφώνησαν από όσα έλεγξαν, οι ήπειροι και τα δίκτυα ανάμεσά τους, και ο κανόνας που ίσχυε τότε. Ένα monitor.partial σημαίνει ότι μία περιοχή δεν μπορούσε να φτάσει το site ενώ οι υπόλοιπες μπορούσαν· είναι πληροφορία, όχι διακοπή.
Για το υπόλοιπο API: αναφορά, έγγραφο OpenAPI, και κάθε σελίδα τεκμηρίωσης ως Markdown προσθέτοντας .md στη διαδρομή της.
Τελευταία αλλαγή: 6 Νοεμβρίου 2026.