| Parameter | Beschreibung |
|---|---|
| Hinweis | Der API-Key sowie das API-Secret müssen über die Verwaltung angelegt werden. Es können bis zu 5 Keys angelegt werden. |
| API_URL | https://ts3dns.in/api/ |
| API_KEY | Der API_KEY wird für die Authentifikation an der API genutzt. Dies kann man auch als PublicKey ansehen. |
| API_SECRET | Das API_SECRET ist der Privateschlüssel zum PublicKey. Ohne diesen ist es nicht möglich Befehle auf der API auszuführen. Der API_KEY funktionert ohne das passende Secret nicht. |
| Beispiel |
PHP-Klasse hier herunterladen
<?php
require_once("ts3dns.class.php");
define('API_URL', 'https://ts3dns.in/api/');
define('API_KEY','u3JCQf2BCLd2CVQzBQvWbL7gQV3Wa8');
define('API_SECRET','mQfDSngbEgihivlNc7sl');
?>
|
| Statusmeldung | Beschreibung |
|---|---|
| IPV4_ONLY | Bitte gebe eine IPv4 Adresse an. IPv6 wird noch nicht unterstützt |
| DOMAIN_EXISTS | Die (Sub-)Domain existiert bereits in unserem System |
| DOMAIN_ADDED | Die (Sub-)Domain wurde in unserem System hinzugefügt |
| DOMAIN_EDITED | Die (Sub-)Domain wurde in unserem System geändert |
| DOMAIN_DELETED | Die (Sub-)Domain wurde aus unserem System gelöscht |
| DB_ERROR | Unbekannter Datenbankfehler. Bitte an einen Adminstrator wenden |
| METHOD_NOT_EXISTS | Diese Methode existiert nicht. |
| METHOD_NOT_GIVEN | Es wurde keine Methode angegeben |
| LOGIN_FAILED | Login in die API fehlgeschlagen |
| API_OFFLINE | Die API ist temporär nicht verfügbar |
| TSDNS_LIMIT | Das Limit an TSDNS Einträgen ist erreicht |
| REQUEST_LIMIT | Das Request-Limit ist aufgebraucht |
| NO_API_KEY_OR_SECRET | API-Key oder API-Secret wurde nicht angegeben |
| API_KEY_OR_SECRET_ERROR | Der API-Key oder API-Secret passen nicht zusammen oder existieren nicht |
| NO_API_KEY_OR_SECRET | API-Key oder API-Secret wurde nicht angegeben |
| Methode | Beispiel |
|---|---|
| Hinzufügen (add) |
<?php
ts3dns::connect(API_URL);
$result = ts3dns::sendPost(array(
'key'=>API_KEY,
'secret'=>API_SECRET,
'method'=>'add',
'name'=>'blubb.ts3dns.in',
'ip'=>'1.2.3.4',
'port'=>'1234',
'owndomain'=>'1'
));
if(!empty($result['error'])) {
echo $result['error'];
}
elseif(isset($result['success'])) {
echo $result['success'];
}
$domainID = $result['domain_id'];
// Returns the DomainID from our System
ts3dns::disconnect();
?>
Der Parameter owndomain muss angegeben werden1 / 0 (1 = eigene Domain hinzufügen / 0 = Subdomain von ts3dns.in nutzen) |
| Editieren (edit) |
<?php
ts3dns::connect(API_URL);
$result = ts3dns::sendPost(array(
'key'=>API_KEY,
'secret'=>API_SECRET,
'method'=>'edit',
'name'=>'blubb.ts3dns.in',
'ip'=>'122.222.123.123',
'port'=>'1234',
'owndomain'=>'1',
'domain_id'=>'6'
));
if(!empty($result['error'])) {
echo $result['error'];
}
elseif(!empty($result['success'])) {
echo $result['success'];
}
ts3dns::disconnect();
?>
Der Parameter owndomain muss angegeben werden1 / 0 (1 = eigene Domain bearbeiten / 0 = Subdomain von ts3dns.in bearbeiten) |
| Löschen (delete) |
<?php
ts3dns::connect(API_URL);
$result = ts3dns::sendPost(array(
'key'=>API_KEY,
'secret'=>API_SECRET,
'method'=>'delete',
'domain_id'=>'6'
));
if(!empty($result['error'])) {
echo $result['error'];
}
elseif(!empty($result['success'])) {
echo $result['success'];
}
ts3dns::disconnect();
?>
|