Healthcheck Ping // Healthcheck API

Healthcheck Pings müssen regelmäßig vom System erkannt werden. Das System nimmt Anfragen auf diversen Methoden an.

You need Help? | v64 Support Forum
Healthcheck PING

Health Ping URL:
https://ipv64.net/health
https://ipv64.net/health.php

Healthcheck Ping Authentication
key|token|healthtoken:[GET|POST] - Dein Healthcheck Token (Option 1)
Bearer Token: Dein Healthcheck Token (Option 2)
Basic Auth Base64: {xyz}:{Healthcheck Token} - Dein Healthcheck Token (Option 3)

Health Ping Limits
Health Ping Limit: API Limit ist abhängig von der Account Klasse. (Default 72 / 24h)
Health Ping Call Limit: Maximal 3 Updater-Anfragen innerhalb 10 Sek.


Health Ping Calls in der Übersicht

[GET|POST] HTTP/S Request - Anfrage

key|token|healthtoken - Healthcheck Ping mit dem Healthtoken (Pflichtfeld)

[POST] HTTP/S Request - Start & Pause/Maintenance

stop|maintenance - Pausiere den Healthcheck Alarm bis dieser wieder aktiviert wird.
start - Pausierten Healthcheck wieder aktivieren.

[POST] HTTP/S Request - Payload

payload|data - Sende eigene Informationen in den nächsten Ping Event Log. [String]


Updater Response - Antwort

HTTP-Header-Codes: 200 OK, 400 Bad Request, 401 Unauthorized, 429 Too Many Requests


Health Check Beispiele

Beispiel 1:
https://ipv64.net/health.php?token=f3247943zfg8347gtz8537
Beispiel 2 (Pause):
https://ipv64.net/health.php?token=f3247943zfg8347gtz8537&pause
Beispiel 3 (Start):
https://ipv64.net/health.php?token=f3247943zfg8347gtz8537&start
Beispiel 4 (Payload):
https://ipv64.net/health.php?token=f3247943zfg8347gtz8537
[POST Request] Field: payload|data -> 'Deine String Daten'

CURL Beispiel:
curl -sSL -H "Authorization: Basic $(echo -n none:f3247943zfg8347gtz8537 | base64)" https://ipv64.net/health.php

IPv64.net API - Healthcheck

API URL
https://ipv64.net/api.php
https://ipv64.net/api

API Authentication
Bearer Token: Dein Account API Key (Option 1)
Basic Auth Base64: {xyz}:{apikey} - Dein Account API Key (Option 2)
apikey|token:[GET|POST] - Dein Account API Key (Option 3)

API Limits
API Account Limit: API Limit ist abhängig von der Account Klasse. (Default 64 / 24h)
API Call Limit: Maximal 5 API-Anfragen innerhalb 10 Sek.


API Calls in der Übersicht

[GET] Healthcheck Informations
[GET] get_healthchecks
&events => Zeige zusätzlich die letzten 100 Events
Erhalte alle Informationen über die hinterlegten Healthchecks

[GET] Healthcheck Statistiken
[GET] get_healthcheck_statistics
[GET] healthtoken => Filtert mit dem Healthtoken nur diesen Healthcheck [Optional]
Erhalte Statistiken zum Healthcheck

[GET] Integrations Informations
[GET] get_integrations
Erhalte alle Informationen über die hinterlegten Integrationen

[POST] Integration hinzufügen (form-data)
[POST] add_integration => Integration Typ [String Format: '']
[POST] integration_name => Integrations Name [String Format: 'XYZ Name 007']
[Options] Options => Informationen folgen
Erstellt eine neue Integration.

[POST] Healthcheck erstellen (form-data)
[POST] add_healthcheck => Healthcheck Name [String Format: 'Healthcheck #002']
[POST] alarm_count => Zeitangabe [Number Format: 1...60]
[POST] alarm_unit => 1 (Min.), 2 (Std.), 3 (Tag.) [Number Format: '1','2','3']
Erstellt einen neuen Healthcheck.

[POST] Healthcheck bearbeiten (form-data)
[POST] edit_healthcheck => Healthcheck Token [String Format: 'gh37thbnfv73.....']
[POST] healthcheck_name => Healthcheck Name [String Format: 'Healthcheck #002']
[POST] alarm_count => Zeitangabe [Number Format: 1...60]
[POST] alarm_unit => 1 (Min.), 2 (Std.), 3 (Tag.) [Number Format: '1','2','3']
Optional
[POST] integration => Integration ID(s) [String][Multiple Format: '514,77,9'][Default: 0]
[POST] grace_count => Karenzzeit [Number Format: 1...60][Default:'30']
[POST] grace_unit => 1 (Min.), 2 (Std.), 3 (Tag.) [Number Format: '1','2','3'][Default:'1']
[POST] alarm_down => Alarm bei Down [Number: '0' or '1'][Default:'1']
[POST] alarm_up => Info bei Up [Number: '0' or '1'][Default:'0']
Bearbeite einen vorhandenen Healthcheck.

[POST] Healthcheck pausieren (form-data)
[POST] pause_healthcheck => Healthcheck Token [String Format: 'gh37thbnfv73.....']
Pausiere einen Healthcheck.

[POST] Healthcheck starten (form-data)
[POST] start_healthcheck => Healthcheck Token [String Format: 'gh37thbnfv73.....']
Starte nach Pause einen Healthcheck.

[DELETE] Healthcheck löschen (x-www-form-urlencoded)
[DELETE] del_healthcheck => Healthcheck Token [String Format: 'gh37thbnfv73.....']
Healthcheck und alle dazugehörigen Events werden gelöscht.


API-Response (Response)

HTTP-Header-Codes: 200 OK, 201 Created, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 429 Too Many Requests

JSON-Payload:
Response: Antwort auf deinen API-Call
Status: success OR http header code
API-Call: Welcher Call wurde aufgerufen.


API Beispiele

[GET] API Get Healthchecks Info:
curl -X GET https://ipv64.net/api.php?get_healthchecks -H "Authorization: Bearer 123456787654321234567876543"

[POST] API Create Healthcheck:
curl -X POST https://ipv64.net/api.php -H "Authorization: Bearer 123456787654321234567876543" -d "add_healthcheck=health001,alarm_count=30,alarm_unit=2"

[DELETE] API Delete Healthcheck:
curl -X DELETE https://ipv64.net/api.php -H "Authorization: Bearer 123456787654321234567876543" -d "del_healthcheck=ghj85hbnfg84...."