Λογότυπο Zagl

Τεκμηρίωση API

Συντόμευσε συνδέσμους μέσα από τον κώδικά σου. Ένα endpoint, ένα bearer token.

Endpoint

POSThttps://za.gl/api/shorten
RESTΣώμα JSONBearer auth

Ταυτοποίηση

Στείλε το API token σου στην κεφαλίδα Authorization ως bearer token. Θα το βρεις στον πίνακα του λογαριασμού σου, αφού δημιουργήσεις τον πρώτο σου σύνδεσμο.

Κεφαλίδα
Authorization: Bearer YOUR_API_TOKEN

Δεν έχεις token ακόμα; Μπορείς να καλέσεις το endpoint και χωρίς. Το Za.gl φτιάχνει ανώνυμο λογαριασμό στη στιγμή και επιστρέφει νέο token στο data.newAuthToken. Αποθήκευσέ το για να διαχειρίζεσαι τους συνδέσμους σου αργότερα.

Σώμα αιτήματος

originalUrlυποχρεωτικό

string

Το μεγάλο URL προς συντόμευση. Αν παραλείψεις το πρωτόκολλο, προστίθεται https:// αυτόματα.

customAlias

string

Δική σου κατάληξη, π.χ. za.gl/my-link. Πρέπει να είναι μοναδική, αλλιώς παίρνεις 409.

password

string

Προστάτεψε τον σύνδεσμο, ώστε οι επισκέπτες να χρειάζονται κωδικό για να συνεχίσουν.

expiresAt

string (ISO date)

Πότε σταματά να δουλεύει ο σύνδεσμος. Πρέπει να είναι στο μέλλον.

expiresInMinutes / expiresInHours / expiresInDays

number

Εναλλακτική του expiresAt, λήξη μετά από σχετικό χρονικό διάστημα.

waitTimer

number (0-300)

Δευτερόλεπτα αναμονής του επισκέπτη στη σελίδα προεπισκόπησης πριν την ανακατεύθυνση.

customGtmId

string

Το δικό σου Google Tag Manager ID (GTM-XXXXXXX) που ενεργοποιείται στη σελίδα προεπισκόπησης.

title / description

string

Προαιρετικά metadata που αποθηκεύονται μαζί με τον σύνδεσμο.

generateQR

boolean

Επιστρέφει και QR για το σύντομο URL.

Παράδειγμα αιτήματος

POSTcURL
curl -X POST https://za.gl/api/shorten \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "password": "optional-secret",
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "waitTimer": 5
  }'

Παράδειγμα απάντησης

Μια επιτυχημένη κλήση επιστρέφει 200 OK με το σύντομο URL στο data.shortUrl.

200 OKJSON
{
  "success": true,
  "message": "URL shortened successfully",
  "data": {
    "id": "123",
    "alias": "my-link",
    "shortUrl": "https://za.gl/my-link",
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "domain": "za.gl",
    "title": "",
    "description": null,
    "hasPassword": true,
    "isActive": true,
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "hits": 0,
    "waitTimer": 5,
    "created": "2026-06-25T10:00:00.000Z",
    "modified": "2026-06-25T10:00:00.000Z",
    "authToken": "your-account-token"
  }
}

Όρια ρυθμού και σφάλματα

10 req/minΈως 10 αιτήματα το λεπτό ανά client.
409Το προσαρμοσμένο alias είναι ήδη πιασμένο.
400Μη έγκυρο URL ή ημερομηνία λήξης στο παρελθόν.
429Έφτασες το όριο ρυθμού ή το μηνιαίο σου όριο.