API

Δημιούργησε και διαχειρίσου σύντομους συνδέσμους από scripts και εφαρμογές. Το API είναι δωρεάν. Φτιάξε ένα κλειδί στον πίνακα ελέγχου σου, στην ενότητα Κλειδιά API, και στείλ' το ως bearer token.

Έλεγχος ταυτότητας

Authorization: Bearer gz_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Τα κλειδιά εμφανίζονται μία φορά. Αντιμετώπισέ τα σαν κωδικούς πρόσβασης: όποιος έχει το κλειδί σου μπορεί να δημιουργεί και να επεξεργάζεται συνδέσμους στον λογαριασμό σου. Ανακάλεσε ένα κλειδί που διέρρευσε από τον πίνακα ελέγχου.

Όρια

• 60 αιτήματα ανά λεπτό ανά κλειδί.
• 500 νέοι σύνδεσμοι την ημέρα ανά λογαριασμό.
• Οι προορισμοί ελέγχονται με το Google Safe Browsing και τη λίστα αποκλεισμού μας. Άλλες υπηρεσίες σύντμησης συνδέσμων δεν μπορούν να χρησιμοποιηθούν ως προορισμοί.

Δημιουργία συνδέσμου

curl -X POST https://gozi.to/api/my/links \
  -H "Authorization: Bearer $GOZI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/launch", "code": "launch"}'

Το code είναι προαιρετικό (4–32 γράμματα, αριθμοί, - ή _). Παράλειψέ το για έναν τυχαίο κωδικό 7 χαρακτήρων. Απόκριση 201:

{
  "link": {
    "code": "launch",
    "shortUrl": "https://gozi.to/launch",
    "url": "https://example.com/launch",
    "status": "active",
    "statusReason": null,
    "custom": true,
    "createdAt": 1790000000000,
    "expiresAt": null
  }
}

Λίστα συνδέσμων

GET /api/my/links?limit=25&cursor=<nextCursor>&q=<search>&clicks=1

Τα νεότερα πρώτα. Πέρασε το nextCursor από την προηγούμενη σελίδα για να πάρεις την επόμενη. Το clicks=1 προσθέτει τα συνολικά ανθρώπινα κλικ.

Ανάγνωση, επεξεργασία, διαγραφή

GET    /api/my/links/{code}
PATCH  /api/my/links/{code}   {"url": "https://new.example"}  or  {"status": "disabled" | "active"}
DELETE /api/my/links/{code}

Στατιστικά

GET /api/my/links/{code}/stats

Επιστρέφει τα ανθρώπινα κλικ των τελευταίων 90 ημερών και όλων των εποχών, τα κλικ ανά ημέρα, καθώς και τις κορυφαίες χώρες, πηγές προέλευσης, συσκευές, προγράμματα περιήγησης και λειτουργικά συστήματα. Τα bots και οι προεπισκοπήσεις συνδέσμων (Slack, WhatsApp κ.ο.κ.) μετριούνται ξεχωριστά στο botClicks. Τα αποτελέσματα αποθηκεύονται στην cache για περίπου 5 λεπτά.

Σφάλματα

Τα σφάλματα χρησιμοποιούν κωδικούς κατάστασης HTTP και ένα σώμα JSON:

{ "error": { "code": "slug_taken", "message": "That custom link is already taken." } }

• 400 μη έγκυρη είσοδος (invalid_url, invalid_slug, …)
• 401 κλειδί που λείπει, δεν είναι έγκυρο ή έχει ανακληθεί
• 409 ο προσαρμοσμένος σύνδεσμος είναι ήδη πιασμένος
• 422 ο προορισμός δεν επιτρέπεται (destination_blocked)
• 429 συμπληρώθηκε το όριο ρυθμού ή το ημερήσιο όριο

Μια περιγραφή κάθε endpoint, αναγνώσιμη από μηχανή, βρίσκεται στο /openapi.json.