API

Kurzlinks direkt aus deinem eigenen Code anlegen und verwalten.

Melde dich an, um deinen persönlichen API-Token zu erhalten. Anmelden

Dokumentation

Sende deinen Token bei jeder Anfrage im Authorization-Header. Request-Bodys sind JSON.

Authorization: Bearer <your_api_token>

Endpunkte

Endpoint	Beschreibung	Kosten
GET `?action=status`	Aktueller Verbrauch und Limits	0
POST `?action=create_link`	Kurzlink anlegen (fullurl, redirectmode, optional premiumshort)	1
POST `?action=update_link`	Ziel und/oder Art ändern (id oder short_tag)	1
POST `?action=delete_link`	Kurzlink löschen (id oder short_tag)	0

Weiterleitungsarten

1 – Direkt: Besucher werden sofort weitergeleitet. Die schnellste Variante.
2 – Paged View: Besucher sehen zuerst Ziel-Adresse und Vorschau und entscheiden dann selbst.
3 – Safe View: Wir laden die Seite für den Besucher – ohne Scripts und Tracker, seine IP bleibt vor dem Ziel verborgen.

Beispiele

`?action=status`

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://hidelink.top/api.php?action=status"

<?php
$ch = curl_init('https://hidelink.top/api.php?action=status');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer YOUR_TOKEN'],
]);
$result = json_decode(curl_exec($ch), true);
print_r($result);

`?action=create_link`

curl -X POST "https://hidelink.top/api.php?action=create_link" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"fullurl":"https://example.com/","redirectmode":1}'

<?php
$data = [
    'fullurl'      => 'https://example.com/',
    'redirectmode' => 1,            // 1 = direct, 2 = paged view, 3 = safe view
    // 'premiumshort' => 'my-name', // optional
];
$ch = curl_init('https://hidelink.top/api.php?action=create_link');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer YOUR_TOKEN',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => json_encode($data),
]);
$result = json_decode(curl_exec($ch), true);
echo $result['short_url'] ?? $result['error'];

`?action=update_link`

curl -X POST "https://hidelink.top/api.php?action=update_link" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"short_tag":"my-name","fullurl":"https://example.com/new","redirectmode":2}'

<?php
$data = [
    'short_tag'    => 'my-name',  // or 'id' => 123
    'fullurl'      => 'https://example.com/new',
    'redirectmode' => 2,
];
// same cURL call as create_link, action=update_link

`?action=delete_link`

curl -X POST "https://hidelink.top/api.php?action=delete_link" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"short_tag":"my-name"}'

<?php
$data = ['short_tag' => 'my-name']; // or 'id' => 123
// same cURL call as create_link, action=delete_link

Beispiel-Antwort

{
  "success": true,
  "short_url": "https://hidelink.top/aB3xK9p",
  "short_tag": "aB3xK9p",
  "redirect_mode": 1,
  "usage": { "limit": 1000, "used": 12, "remaining": 988, "month": "2026-10" }
}

Fehler liefern "success": false mit einer "error"-Meldung und passendem HTTP-Status (400, 401, 403, 404, 429).