Λογαριασμός

Διαχειριστείτε κλειδιά API για τον λογαριασμό AgentSend σας. Δημιουργήστε κλειδιά για νέους πράκτορες ή ενσωματώσεις, δείτε υπάρχοντα κλειδιά σε λίστα και ανακαλέστε οποιοδήποτε κλειδί άμεσα.

⚠

Η πλήρης τιμή κλειδιού API επιστρέφεται μόνο μία φορά κατά τη δημιουργία. Αποθηκεύστε την με ασφάλεια (π.χ. σε secrets manager ή μεταβλητή περιβάλλοντος) — δεν μπορεί να ανακτηθεί ξανά.

Δημιουργία Κλειδιού API

POST /account/api-keys

Δημιουργεί νέο κλειδί API για τον αυθεντικοποιημένο λογαριασμό. Η απάντηση περιλαμβάνει την πλήρη συμβολοσειρά κλειδιού· αυτή είναι η μόνη φορά που θα είναι ορατή.

Σώμα Request

Content-Type: application/json

Πεδίο	Τύπος	Περιγραφή
`name`	string	Αναγνώσιμη από άνθρωπο ετικέτα για το κλειδί (π.χ. `"production-agent"`). Προαιρετικό.

Παράδειγμα Request

bash

curl -X POST https://api.agentsend.io/account/api-keys \
  -H "x-api-key: $AGENTSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production-agent"}'

Απάντηση — 201 Created

json

{
  "id": "ak_01j9zxkp4qbc7n3m8td5e6fvg2",
  "key": "as_live_v1_4xKqT2mNpRuWsYcBjDeGhLzA...",
  "prefix": "as_live_v1_4xKq",
  "name": "production-agent",
  "message": "Store this key securely. It will not be shown again."
}

Αντικείμενο CreatedApiKey

Πεδίο	Τύπος	Περιγραφή
`id`	string	Μοναδικό αναγνωριστικό για το κλειδί API.
`key`	string	Η πλήρης τιμή κλειδιού API. Εμφανίζεται μόνο μία φορά.
`prefix`	string	Το ορατό πρόθεμα που χρησιμοποιείται για την αναγνώριση αυτού του κλειδιού σε λίστες.
`name`	string \| null	Αναγνώσιμη από άνθρωπο ετικέτα που παρέχεται κατά τη δημιουργία.
`message`	string	Ενημερωτικό μήνυμα που σας υπενθυμίζει να αποθηκεύσετε το κλειδί με ασφάλεια.

Λίστα Κλειδιών API

GET /account/api-keys

Επιστρέφει όλα τα ενεργά κλειδιά API στον λογαριασμό. Οι τιμές κλειδιών δεν επιστρέφονται ποτέ σε αυτό το endpoint — εκτίθενται μόνο metadata.

Παράδειγμα Request

bash

curl https://api.agentsend.io/account/api-keys \
  -H "x-api-key: $AGENTSEND_API_KEY"

Απάντηση — 200 OK

json

{
  "data": [
    {
      "id": "ak_01j9zxkp4qbc7n3m8td5e6fvg2",
      "keyPrefix": "as_live_v1_4xKq",
      "name": "production-agent",
      "lastUsedAt": "2025-11-02T14:23:00Z",
      "expiresAt": null,
      "createdAt": "2025-10-15T09:00:00Z"
    },
    {
      "id": "ak_02k0aylq5rcd8o4n9ue6f7gwh3",
      "keyPrefix": "as_live_v1_9mHr",
      "name": null,
      "lastUsedAt": null,
      "expiresAt": "2026-01-01T00:00:00Z",
      "createdAt": "2025-12-01T10:30:00Z"
    }
  ]
}

Αντικείμενο ApiKey

Πεδίο	Τύπος	Περιγραφή
`id`	string	Μοναδικό αναγνωριστικό για το κλειδί API.
`keyPrefix`	string	Το ορατό πρόθεμα του κλειδιού, που χρησιμοποιείται για την αναγνώρισή του χωρίς έκθεση του secret.
`name`	string \| null	Αναγνώσιμη από άνθρωπο ετικέτα, αν οριστεί κατά τη δημιουργία.
`lastUsedAt`	string \| null	Χρονοσήμανση ISO 8601 του τελευταίου αυθεντικοποιημένου request που έγινε με αυτό το κλειδί.
`expiresAt`	string \| null	Χρονοσήμανση ISO 8601 λήξης ή `null` αν το κλειδί δεν λήγει.
`createdAt`	string	Χρονοσήμανση ISO 8601 δημιουργίας του κλειδιού.

Ανάκληση Κλειδιού API

DELETE /account/api-keys/{id}

Ανακαλεί μόνιμα ένα κλειδί API. Οποιαδήποτε requests αυθεντικοποιημένα με αυτό το κλειδί θα απορριφθούν άμεσα. Αυτή η ενέργεια δεν μπορεί να αναιρεθεί.

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

Παράμετρος	Τύπος	Περιγραφή
`id` απαιτείται	uuid	Το ID του κλειδιού API προς ανάκληση.

Παράδειγμα Request

bash

curl -X DELETE https://api.agentsend.io/account/api-keys/ak_01j9zxkp4qbc7n3m8td5e6fvg2 \
  -H "x-api-key: $AGENTSEND_API_KEY"

Απάντηση — 204 No Content

Κενή απάντηση με status 204 επιβεβαιώνει ότι το κλειδί έχει ανακληθεί. Δεν επιστρέφεται σώμα απάντησης.

ℹ

Δεν μπορείτε να ανακαλέσετε το κλειδί που χρησιμοποιείται αυτή τη στιγμή για την αυθεντικοποίηση του request. Χρησιμοποιήστε διαφορετικό κλειδί (ή τον πίνακα ελέγχου) για να ανακαλέσετε ένα κλειδί σε ενεργή χρήση.

← Προηγούμενο API: Τομείς Επόμενο → API: Συνημμένα