Συνημμένα

Ανεβάστε αρχεία στο AgentSend και επισυνάψτε τα σε εξερχόμενα μηνύματα. Ανακτήστε presigned URLs για λήψη ή κοινή χρήση περιεχομένου συνημμένων.

💡

Ανεβάστε πρώτα ένα συνημμένο, μετά αναφέρετε το id του στο πεδίο attachmentIds κατά την αποστολή μηνύματος. Τα συνημμένα αποθηκεύονται με ασφάλεια και είναι προσβάσιμα μέσω presigned URLs περιορισμένου χρόνου.

Ανέβασμα Συνημμένου

POST /attachments

Ανεβάζει αρχείο και επιστρέφει αντικείμενο Attachment. Χρησιμοποιήστε το επιστρεφόμενο id για να επισυνάψετε το αρχείο σε μήνυμα. Το request πρέπει να χρησιμοποιεί κωδικοποίηση multipart/form-data.

Σώμα Request

Content-Type: multipart/form-data

Πεδίο	Τύπος	Περιγραφή
`file` απαιτείται	file	Το αρχείο προς ανέβασμα. Το όνομα αρχείου και ο τύπος περιεχομένου συνάγονται από το ανεβασμένο part.

Παράδειγμα Request

bash

curl -X POST https://api.agentsend.io/attachments \
  -H "x-api-key: $AGENTSEND_API_KEY" \
  -F "file=@/path/to/report.pdf"

javascript

const form = new FormData();
form.append("file", fileBlob, "report.pdf");

const res = await fetch("https://api.agentsend.io/attachments", {
  method: "POST",
  headers: { "x-api-key": process.env.AGENTSEND_API_KEY },
  body: form,
});

const attachment = await res.json();
console.log(attachment.id); // use this id when sending a message

Απάντηση — 201 Created

json

{
  "id": "att_01j9zxkp4qbc7n3m8td5e6fvg2",
  "filename": "report.pdf",
  "contentType": "application/pdf",
  "size": 204800,
  "url": "https://storage.agentsend.io/att_01j9zxkp4qbc7n3m8td5e6fvg2/report.pdf?token=...",
  "createdAt": "2025-11-10T08:15:00Z"
}

Λήψη Συνημμένου

GET /attachments/{id}

Ανακτά metadata και βραχύβιο presigned URL λήψης για συνημμένο. Χρησιμοποιήστε το πεδίο url για να κατεβάσετε ή να εμφανίσετε απευθείας το περιεχόμενο του αρχείου.

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

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

Παράδειγμα Request

bash

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

Απάντηση — 200 OK

json

{
  "id": "att_01j9zxkp4qbc7n3m8td5e6fvg2",
  "filename": "report.pdf",
  "contentType": "application/pdf",
  "size": 204800,
  "url": "https://storage.agentsend.io/att_01j9zxkp4qbc7n3m8td5e6fvg2/report.pdf?token=...",
  "createdAt": "2025-11-10T08:15:00Z"
}

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

Πεδίο	Τύπος	Περιγραφή
`id`	string	Μοναδικό αναγνωριστικό για το συνημμένο.
`filename`	string	Αρχικό όνομα αρχείου όπως παρασχέθηκε κατά το ανέβασμα.
`contentType`	string	Τύπος MIME του αρχείου (π.χ. `application/pdf`, `image/png`).
`size`	number	Μέγεθος αρχείου σε bytes.
`url`	string	Presigned URL για λήψη του αρχείου. Αυτό το URL έχει περιορισμένη διάρκεια· ανακτήστε νέο καλώντας αυτό το endpoint ξανά αν λήξει.
`createdAt`	string	Χρονοσήμανση ISO 8601 ανεβάσματος του συνημμένου.

ℹ

Τα presigned URLs λήγουν μετά από σύντομο διάστημα. Αν χρειάζεστε να μοιραστείτε ή να ξανακατεβάσετε συνημμένο, καλέστε το GET /attachments/{id} ξανά για να λάβετε νέο URL.

← Προηγούμενο API: Λογαριασμός