Αυθεντικοποίηση
Η StarDots πραγματοποιεί αυθεντικοποίηση διαβάζοντας το πεδίο κεφαλίδας στο αίτημα HTTP που ξεκινά ο πελάτης και επαληθεύοντας τα σχετικά πεδία. Επομένως, όλα τα αιτήματα ανοικτού API πρέπει να περιλαμβάνουν αυτές τις πληροφορίες αυθεντικοποίησης και πρέπει να σημειώσετε ότι αυτά τα πεδία είναι ευαίσθητα σε πεζά-κεφαλαία και όλα τα πεδία πρέπει να είναι με πεζά.
| Όνομα | Περιγραφή |
|---|---|
x-stardots-timestamp | Τρέχον χρονικό σήμα σε δευτερόλεπτα. Η διαφορά με τον διακομιστή StarDots δεν μπορεί να υπερβεί τα 60 δευτερόλεπτα. Σημείωση: Η ζώνη ώρας του StarDots είναι Asia/Singapore, η οποία είναι UTC+8. |
x-stardots-nonce | Μια τυχαία συμβολοσειρά από 4 έως 20 χαρακτήρες, η οποία μπορεί να περιέχει μόνο κεφαλαία γράμματα, πεζά γράμματα και αριθμούς. Σημειώστε ότι αυτή η τιμή πρέπει να είναι μοναδική εντός 60 δευτερολέπτων. |
x-stardots-key | Πληροφορίες κλειδιού που εκδίδονται από την StarDots. |
x-stardots-sign | Το πεδίο υπογραφής είναι μια συμβολοσειρά που δημιουργείται συνδυάζοντας τα παραπάνω πεδία σύμφωνα με έναν συγκεκριμένο αλγόριθμο υπογραφής. Ο συγκεκριμένος αλγόριθμος υπογραφής θα παρουσιαστεί στη συνέχεια. |
x-stardots-timestamp- Περιγραφή
- Τρέχον χρονικό σήμα σε δευτερόλεπτα. Η διαφορά με τον διακομιστή StarDots δεν μπορεί να υπερβεί τα 60 δευτερόλεπτα. Σημείωση: Η ζώνη ώρας του StarDots είναι Asia/Singapore, η οποία είναι UTC+8.
x-stardots-nonce- Περιγραφή
- Μια τυχαία συμβολοσειρά από 4 έως 20 χαρακτήρες, η οποία μπορεί να περιέχει μόνο κεφαλαία γράμματα, πεζά γράμματα και αριθμούς. Σημειώστε ότι αυτή η τιμή πρέπει να είναι μοναδική εντός 60 δευτερολέπτων.
x-stardots-key- Περιγραφή
- Πληροφορίες κλειδιού που εκδίδονται από την StarDots.
x-stardots-sign- Περιγραφή
- Το πεδίο υπογραφής είναι μια συμβολοσειρά που δημιουργείται συνδυάζοντας τα παραπάνω πεδία σύμφωνα με έναν συγκεκριμένο αλγόριθμο υπογραφής. Ο συγκεκριμένος αλγόριθμος υπογραφής θα παρουσιαστεί στη συνέχεια.
Αλγόριθμος Υπογραφής
Υποθέτουμε τις παρακάτω τιμές πεδίων
key2dcded8e-f231-4d0a-8498-d10ef0639eb3secretEy1JNRCiJOzaIOIilcyJvteTn5YXykFXUwmiHLymK8LHkITfGPo5mTUdLlg0jPHST9fMwMZKxIKUBvSsT5uxrq0lXuerll3eRW2tbMOsvySRY539L8cR6iRFV2DQqdlzbseyq7k9N0U5pZgj6f43e3MngbIttgSDl1G44IBOwqsI2HVXE5H6mf1bHlvWw6Ziuk8Xcw18AioG47SFBLIatrq6E9yEBJgFgcYysCH8JvY659hhqI3Ii1CA5zVtyNpx-stardots-timestamp1728958751x-stardots-noncefQvDmMLnKEx-stardots-key2dcded8e-f231-4d0a-8498-d10ef0639eb3
Στη συνέχεια, συναρμολογούμε τις παραπάνω τιμές πεδίων
needSignStr = x-stardots-timestamp + "|" + secret + "|" + x-stardots-nonceΣτη συνέχεια, υπολογίζουμε τη σύνοψη MD5 της συμβολοσειράς που συναρμολογήσαμε παραπάνω
signStrAfterMD5 = md5("1728958751|Ey1JNRCiJOzaIOIilcyJvteTn5YXykFXUwmiHLymK8LHkITfGPo5mTUdLlg0jPHST9fMwMZKxIKUBvSsT5uxrq0lXuerll3eRW2tbMOsvySRY539L8cR6iRFV2DQqdlzbseyq7k9N0U5pZgj6f43e3MngbIttgSDl1G44IBOwqsI2HVXE5H6mf1bHlvWw6Ziuk8Xcw18AioG47SFBLIatrq6E9yEBJgFgcYysCH8JvY659hhqI3Ii1CA5zVtyNp|fQvDmMLnKE")
signStrAfterMD5 = "51dabfe4b47e73d4a3b85fe29c4f1e82"Τέλος, μετατρέπουμε τη σύνοψη σε κεφαλαία
sign = signStrAfterMD5.toUpperCase()
sign = "51DABFE4B47E73D4A3B85FE29C4F1E82"Επομένως, η τελική τιμή του πεδίου x-stardots-sign είναι 51DABFE4B47E73D4A3B85FE29C4F1E82
Κοινό σώμα απάντησης HTTP
Όλες οι απαντήσεις από τα interfaces διατηρούν μια ενιαία δομή δεδομένων
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
code | αριθμός | Ναι | Κωδικός απάντησης της υπηρεσίας. Ο κωδικός 200 υποδεικνύει επιτυχία. |
message | συμβολοσειρά | Ναι | Μήνυμα αποτελέσματος λειτουργίας. |
requestId | συμβολοσειρά | Ναι | Ένας μοναδικός αριθμός για το αίτημα, ο οποίος μπορεί να χρησιμοποιηθεί για την επίλυση προβλημάτων. |
success | boolean | Ναι | Υποδεικνύει αν η επιχειρηματική λειτουργία ήταν επιτυχής. |
ts | αριθμός | Ναι | Χρονικό σήμα σε χιλιοστά του δευτερολέπτου από τον διακομιστή. |
data | οποιοδήποτε | Ναι | Πεδίο δεδομένων επιχείρησης. Αυτό το πεδίο μπορεί να έχει οποιοδήποτε τύπο δεδομένων. Για συγκεκριμένους τύπους δεδομένων, ανατρέξτε στο αντίστοιχο interface. |
code- Τύπος δεδομένων
αριθμός- Απαιτείται
- Ναι
- Περιγραφή
- Κωδικός απάντησης της υπηρεσίας. Ο κωδικός 200 υποδεικνύει επιτυχία.
message- Τύπος δεδομένων
συμβολοσειρά- Απαιτείται
- Ναι
- Περιγραφή
- Μήνυμα αποτελέσματος λειτουργίας.
requestId- Τύπος δεδομένων
συμβολοσειρά- Απαιτείται
- Ναι
- Περιγραφή
- Ένας μοναδικός αριθμός για το αίτημα, ο οποίος μπορεί να χρησιμοποιηθεί για την επίλυση προβλημάτων.
success- Τύπος δεδομένων
boolean- Απαιτείται
- Ναι
- Περιγραφή
- Υποδεικνύει αν η επιχειρηματική λειτουργία ήταν επιτυχής.
ts- Τύπος δεδομένων
αριθμός- Απαιτείται
- Ναι
- Περιγραφή
- Χρονικό σήμα σε χιλιοστά του δευτερολέπτου από τον διακομιστή.
data- Τύπος δεδομένων
οποιοδήποτε- Απαιτείται
- Ναι
- Περιγραφή
- Πεδίο δεδομένων επιχείρησης. Αυτό το πεδίο μπορεί να έχει οποιοδήποτε τύπο δεδομένων. Για συγκεκριμένους τύπους δεδομένων, ανατρέξτε στο αντίστοιχο interface.
Λειτουργικό Interface
Σημειώστε ότι όλα τα interfaces θα έχουν όρια ρυθμού αιτημάτων και όλα τα interfaces μοιράζονται ένα σύνολο κανόνων περιορισμού ρυθμού. Μέχρι στιγμής, το όριο ρυθμού του StarDots είναι 300 φορές ανά λεπτό.
Διαδρομή αιτήματος
https://api.stardots.ioΛίστα Χώρων
Αποκτήστε δεδομένα λίστας χώρων.
- Μέθοδος αιτήματος
GET- Διαδρομή αιτήματος
/openapi/space/list- Τύπος περιεχομένου αιτήματος
application/json- Τύπος περιεχομένου απάντησης
application/json
Παράμετροι αιτήματος
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
page | αριθμός | Όχι | Αριθμός σελίδας, η προεπιλεγμένη τιμή είναι 1. |
pageSize | αριθμός | Όχι | Ο αριθμός των καταχωρήσεων ανά σελίδα κυμαίνεται από 1 έως 100, και η προεπιλεγμένη τιμή είναι 20. |
page- Τύπος δεδομένων
αριθμός- Απαιτείται
- Όχι
- Περιγραφή
- Αριθμός σελίδας, η προεπιλεγμένη τιμή είναι 1.
pageSize- Τύπος δεδομένων
αριθμός- Απαιτείται
- Όχι
- Περιγραφή
- Ο αριθμός των καταχωρήσεων ανά σελίδα κυμαίνεται από 1 έως 100, και η προεπιλεγμένη τιμή είναι 20.
Δημοκρασία αιτήματος
/openapi/space/list?page=1&pageSize=50Πεδία απάντησης
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
name | συμβολοσειρά | Ναι | Το όνομα του χώρου. |
public | boolean | Ναι | Εάν η προσβασιμότητα του χώρου είναι ψευδής. |
createdAt | αριθμός | Ναι | Το χρονικό σήμα του συστήματος σε δευτερόλεπτα όταν δημιουργήθηκε ο χώρος. Η ζώνη ώρας είναι UTC+8. |
fileCount | αριθμός | Ναι | Ο αριθμός των αρχείων σε αυτόν τον χώρο. |
name- Τύπος δεδομένων
συμβολοσειρά- Απαιτείται
- Ναι
- Περιγραφή
- Το όνομα του χώρου.
public- Τύπος δεδομένων
boolean- Απαιτείται
- Ναι
- Περιγραφή
- Εάν η προσβασιμότητα του χώρου είναι ψευδής.
createdAt- Τύπος δεδομένων
αριθμός- Απαιτείται
- Ναι
- Περιγραφή
- Το χρονικό σήμα του συστήματος σε δευτερόλεπτα όταν δημιουργήθηκε ο χώρος. Η ζώνη ώρας είναι UTC+8.
fileCount- Τύπος δεδομένων
αριθμός- Απαιτείται
- Ναι
- Περιγραφή
- Ο αριθμός των αρχείων σε αυτόν τον χώρο.
Δημοκρασία απάντησης
{
"code": 200,
"data": [
{
"createdAt": 1723789637,
"fileCount": 2,
"name": "star",
"public": true
}
],
"message": "SUCCESS",
"requestId": "5686efa5-c747-4f63-8657-e6052f8181a9",
"success": true,
"ts": 1670899688591
}Δημιουργία Χώρου
Δημιουργήστε έναν νέο χώρο.
- Μέθοδος αιτήματος
PUT- Διαδρομή αιτήματος
/openapi/space/create- Τύπος περιεχομένου αιτήματος
application/json- Τύπος περιεχομένου απάντησης
application/json
Παράμετροι αιτήματος
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
space | συμβολοσειρά | Ναι | Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες. |
public | boolean | Όχι | Καθορίζει εάν ο χώρος είναι προσβάσιμος δημόσια. Η προεπιλεγμένη τιμή είναι false. |
space- Τύπος δεδομένων
συμβολοσειρά- Απαιτείται
- Ναι
- Περιγραφή
- Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες.
public- Τύπος δεδομένων
boolean- Απαιτείται
- Όχι
- Περιγραφή
- Καθορίζει εάν ο χώρος είναι προσβάσιμος δημόσια. Η προεπιλεγμένη τιμή είναι false.
Δημοκρασία αιτήματος
{
"public": false,
"space": "stardots"
}Πεδία απάντησης
Δεν υπάρχουν πεδία
Δείγμα απάντησης
{
"code": 200,
"data": null,
"message": "SUCCESS",
"requestId": "5686efa5-c747-4f63-8657-e6052f8181a9",
"success": true,
"ts": 1670899688591
}Διαγραφή Χώρου
Διαγράψτε έναν υπάρχοντα χώρο. Σημειώστε ότι πρέπει να διασφαλίσετε ότι δεν υπάρχουν αρχεία σε αυτόν τον χώρο, διαφορετικά η διαγραφή θα αποτύχει.
- Μέθοδος αιτήματος
DELETE- Διαδρομή αιτήματος
/openapi/space/delete- Τύπος περιεχομένου αιτήματος
application/json- Τύπος περιεχομένου απάντησης
application/json
Παράμετροι αιτήματος
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
space | συμβολοσειρά | Ναι | Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες. |
space- Τύπος δεδομένων
συμβολοσειρά- Απαιτείται
- Ναι
- Περιγραφή
- Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες.
Δημοκρασία αιτήματος
{
"space": "stardots"
}Πεδία απάντησης
Δεν υπάρχουν πεδία
Δείγμα απάντησης
{
"code": 200,
"data": null,
"message": "SUCCESS",
"requestId": "5686efa5-c747-4f63-8657-e6052f8181a9",
"success": true,
"ts": 1670899688591
}Προσβασιμότητα Χώρου
Εναλλάξτε την προσβασιμότητα ενός χώρου.
- Μέθοδος αιτήματος
POST- Διαδρομή αιτήματος
/openapi/space/accessibility/toggle- Τύπος περιεχομένου αιτήματος
application/json- Τύπος περιεχομένου απάντησης
application/json
Παράμετροι αιτήματος
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
space | string | Ναι | Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες. |
public | boolean | Όχι | Καθορίζει αν ο χώρος είναι προσβάσιμος δημόσια. Η προεπιλεγμένη τιμή είναι false. |
space- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες.
public- Τύπος δεδομένων
boolean- Απαιτείται
- Όχι
- Περιγραφή
- Καθορίζει αν ο χώρος είναι προσβάσιμος δημόσια. Η προεπιλεγμένη τιμή είναι false.
Δημοκρασία αιτήματος
{
"public": false,
"space": "stardots"
}Πεδία απάντησης
Δεν υπάρχουν πεδία
Δείγμα απάντησης
{
"code": 200,
"data": null,
"message": "SUCCESS",
"requestId": "5686efa5-c747-4f63-8657-e6052f8181a9",
"success": true,
"ts": 1670899688591
}Λίστα αρχείων στον χώρο
Αποκτήστε τη λίστα των αρχείων στον χώρο. Η λίστα είναι ταξινομημένη σε φθίνουσα σειρά με βάση τον χρόνο ανεβάσματος του αρχείου.
- Μέθοδος αιτήματος
GET- Διαδρομή αιτήματος
/openapi/file/list- Τύπος περιεχομένου αιτήματος
application/json- Τύπος περιεχομένου απάντησης
application/json
Παράμετροι αιτήματος
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
space | string | Ναι | Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες. |
page | number | Όχι | Αριθμός σελίδας, η προεπιλεγμένη τιμή είναι 1. |
pageSize | number | Όχι | Ο αριθμός των εγγραφών ανά σελίδα κυμαίνεται από 1 έως 100, και η προεπιλεγμένη τιμή είναι 20. |
space- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες.
page- Τύπος δεδομένων
number- Απαιτείται
- Όχι
- Περιγραφή
- Αριθμός σελίδας, η προεπιλεγμένη τιμή είναι 1.
pageSize- Τύπος δεδομένων
number- Απαιτείται
- Όχι
- Περιγραφή
- Ο αριθμός των εγγραφών ανά σελίδα κυμαίνεται από 1 έως 100, και η προεπιλεγμένη τιμή είναι 20.
Δημοκρασία αιτήματος
{
"space": "stardots",
"page": 1,
"pageSize": 20,
}Πεδία απάντησης
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
page | number | Ναι | Αριθμός σελίδας, η προεπιλεγμένη τιμή είναι 1. |
pageSize | number | Ναι | Ο αριθμός των εγγραφών ανά σελίδα κυμαίνεται από 1 έως 100, και η προεπιλεγμένη τιμή είναι 20. |
totalCount | number | Ναι | Ο συνολικός αριθμός των εγγραφών. |
list | array<object> | Ναι | Πίνακας με τη λίστα αρχείων. |
list.name | string | Ναι | Το όνομα του αρχείου. |
list.byteSize | number | Ναι | Το μέγεθος του αρχείου σε bytes. |
list.size | string | Ναι | Μέγεθος του αρχείου, σε μορφή ευανάγνωστη. |
list.uploadedAt | number | Ναι | Ο χρόνος ανέβασματος του αρχείου σε δευτερόλεπτα. Η ζώνη ώρας είναι UTC+8. |
list.url | string | Ναι | Η διεύθυνση πρόσβασης του αρχείου. Σημειώστε ότι αν η προσβασιμότητα του χώρου είναι ιδιωτική, η τιμή αυτού του πεδίου θα περιλαμβάνει το εισιτήριο πρόσβασης, το οποίο είναι έγκυρο για 20 δευτερόλεπτα. |
page- Τύπος δεδομένων
number- Απαιτείται
- Ναι
- Περιγραφή
- Αριθμός σελίδας, η προεπιλεγμένη τιμή είναι 1.
pageSize- Τύπος δεδομένων
number- Απαιτείται
- Ναι
- Περιγραφή
- Ο αριθμός των εγγραφών ανά σελίδα κυμαίνεται από 1 έως 100, και η προεπιλεγμένη τιμή είναι 20.
totalCount- Τύπος δεδομένων
number- Απαιτείται
- Ναι
- Περιγραφή
- Ο συνολικός αριθμός των εγγραφών.
list- Τύπος δεδομένων
array<object>- Απαιτείται
- Ναι
- Περιγραφή
- Πίνακας με τη λίστα αρχείων.
list.name- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Το όνομα του αρχείου.
list.byteSize- Τύπος δεδομένων
number- Απαιτείται
- Ναι
- Περιγραφή
- Το μέγεθος του αρχείου σε bytes.
list.size- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Μέγεθος του αρχείου, σε μορφή ευανάγνωστη.
list.uploadedAt- Τύπος δεδομένων
number- Απαιτείται
- Ναι
- Περιγραφή
- Ο χρόνος ανέβασματος του αρχείου σε δευτερόλεπτα. Η ζώνη ώρας είναι UTC+8.
list.url- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Η διεύθυνση πρόσβασης του αρχείου. Σημειώστε ότι αν η προσβασιμότητα του χώρου είναι ιδιωτική, η τιμή αυτού του πεδίου θα περιλαμβάνει το εισιτήριο πρόσβασης, το οποίο είναι έγκυρο για 20 δευτερόλεπτα.
Δείγμα απάντησης
{
"code": 0,
"data": {
"list": [
{
"byteSize": 3600000,
"name": "star",
"size": "35KB",
"uploadedAt": 1723789637,
"url": "https://....."
}
],
"page": 1,
"pageSize": 10,
"totalCount": 1
},
"message": "SUCCESS",
"requestId": "5686efa5-c747-4f63-8657-e6052f8181a9",
"success": true,
"ts": 1670899688591
}Εισιτήριο πρόσβασης αρχείου
Αποκτήστε το εισιτήριο πρόσβασης για το αρχείο. Όταν η προσβασιμότητα του χώρου είναι ιδιωτική, πρέπει να φέρετε το εισιτήριο πρόσβασης για να αποκτήσετε πρόσβαση στα αρχεία του χώρου, διαφορετικά το αίτημα θα απορριφθεί.
- Μέθοδος αιτήματος
POST- Διαδρομή αιτήματος
/openapi/file/ticket- Τύπος περιεχομένου αιτήματος
application/json- Τύπος περιεχομένου απάντησης
application/json
Παράμετροι αιτήματος
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
space | string | Ναι | Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες. |
filename | string | Ναι | Το όνομα του αρχείου. |
space- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες.
filename- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Το όνομα του αρχείου.
Δημοκρασία αιτήματος
{
"filename": "1.jpg",
"space": "stardots"
}Πεδία απάντησης
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
ticket | string | Ναι | Εισιτήριο πρόσβασης. |
ticket- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Εισιτήριο πρόσβασης.
Δείγμα απάντησης
{
"code": 200,
"data": {
"ticket": "a312.."
},
"message": "SUCCESS",
"requestId": "5686efa5-c747-4f63-8657-e6052f8181a9",
"success": true,
"ts": 1670899688591
}Ανέβασμα αρχείου
Ανεβάστε το αρχείο στο χώρο. Σημειώστε ότι αυτό το αίτημα απαιτεί να ξεκινήσετε το αίτημα με τη μορφή φόρμας.
- Μέθοδος αιτήματος
PUT- Διαδρομή αιτήματος
/openapi/file/upload- Τύπος περιεχομένου αιτήματος
multipart/form-data- Τύπος περιεχομένου απάντησης
application/json
Παράμετροι αιτήματος
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
space | string | Ναι | Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες. |
file | binary | Ναι | Η δυαδική ροή του αρχείου. Σημειώστε ότι το όνομα του αρχείου δεν πρέπει να υπερβαίνει τους 170 χαρακτήρες. Το μέγεθος του αρχείου δεν πρέπει να υπερβαίνει τα 10MB. |
space- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες.
file- Τύπος δεδομένων
binary- Απαιτείται
- Ναι
- Περιγραφή
- Η δυαδική ροή του αρχείου. Σημειώστε ότι το όνομα του αρχείου δεν πρέπει να υπερβαίνει τους 170 χαρακτήρες. Το μέγεθος του αρχείου δεν πρέπει να υπερβαίνει τα 10MB.
Πεδία απάντησης
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
space | string | Ναι | Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες. |
filename | string | Ναι | Το όνομα του αρχείου. |
url | string | Ναι | Ο σύνδεσμος πρόσβασης του αρχείου. Εάν η προσβασιμότητα του χώρου είναι ιδιωτική, ο σύνδεσμος πρόσβασης θα περιέχει το εισιτήριο πρόσβασης. |
space- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες.
filename- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Το όνομα του αρχείου.
url- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Ο σύνδεσμος πρόσβασης του αρχείου. Εάν η προσβασιμότητα του χώρου είναι ιδιωτική, ο σύνδεσμος πρόσβασης θα περιέχει το εισιτήριο πρόσβασης.
Δείγμα απάντησης
{
"code": 200,
"data": {
"filename": "1.png",
"space": "space",
"url": "https://i.stardots.io/space/1.png"
},
"message": "SUCCESS",
"requestId": "5686efa5-c747-4f63-8657-e6052f8181a9",
"success": true,
"ts": 1670899688591
}Διαγραφή αρχείων
Διαγράψτε αρχεία στο χώρο. Αυτή η διεπαφή υποστηρίζει λειτουργίες μαζικής επεξεργασίας.
- Μέθοδος αιτήματος
DELETE- Διαδρομή αιτήματος
/openapi/file/delete- Τύπος περιεχομένου αιτήματος
application/json
Παράμετροι αιτήματος
| Όνομα | Τύπος δεδομένων | Απαιτείται | Περιγραφή |
|---|---|---|---|
space | string | Ναι | Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες. |
filenameList | array<string> | Ναι | Πίνακας ονομάτων αρχείων. |
space- Τύπος δεδομένων
string- Απαιτείται
- Ναι
- Περιγραφή
- Το όνομα του χώρου. Μπορεί να είναι μόνο συνδυασμός γραμμάτων ή αριθμών, και το μήκος του είναι από 4 έως 15 χαρακτήρες.
filenameList- Τύπος δεδομένων
array<string>- Απαιτείται
- Ναι
- Περιγραφή
- Πίνακας ονομάτων αρχείων.
Πεδία απάντησης
Δεν υπάρχουν πεδία
{
"code": 0,
"data": null,
"message": "SUCCESS",
"requestId": "5686efa5-c747-4f63-8657-e6052f8181a9",
"success": true,
"ts": 1670899688591
}Κωδικοί απόκρισης διακομιστή
Οι κωδικοί απόκρισης του διακομιστή είναι οι κωδικοί που επιστρέφει ο διακομιστής στον πελάτη για να αναπαραστήσει το αποτέλεσμα της επεξεργασίας της αίτησης.
| Κωδικός | Περιγραφή |
|---|---|
200 | Επιτυχία |
504 | Η αίτηση έχει υπερβεί το χρονικό όριο |
999999 | Σφάλμα εσωτερικού διακομιστή |
100000 | Σφάλμα παραμέτρων αίτησης |
100001 | Η πρόσβαση στο εισιτήριο έχει λήξει |
100002 | Η ανθρώπινη μηχανική επαλήθευση δεν πέρασε |
100003 | Το επαληθευτικό κωδικό δεν είναι σωστός |
100004 | Το χρήστη δεν υπάρχει |
100005 | Οι λογαριασμοί δεν ταιριάζουν |
100006 | Το πρόγραμμα συνδρομής δεν υπάρχει |
100007 | SMS/E-posta gönderimi çok sık |
100008 | SMS/E-posta gönderimi çok sık |
100009 | Alan/Depolama kabı bulunamadı |
100010 | Alan/Depolama kabı mevcut |
100011 | Alan/Depolama kabı dolu değil |
100012 | Η λειτουργία είναι πολύ συχνή |
100013 | Alan/Depolama kabı sayısı kotası doldu |
100014 | Alan/Depolama kabı sayısı kotası doldu |
100015 | Το ρεύμα μεταφοράς έχει καταναλωθεί |
100016 | Το πρόγραμμα συνδρομής δεν ταιριάζει |
100017 | Alan/Depolama kabı dosya erişimi kısıtlı |
100018 | Το αρχείο υπερβαίνει το όριο μεγέθους |
100019 | Το μορφοποίηση αρχείου δεν υποστηρίζεται |
100020 | Referer izni yok |
100021 | Η λειτουργία είναι ανοιχτή μόνο για Pro ή Premium χρήστες |
100022 | Η λειτουργία είναι ανοιχτή μόνο για Premium χρήστες |
100023 | Το πιστοποιητικό περιεχόμενο δεν είναι έγκυρο |
100024 | Το πιστοποιητικό και το ιδιωτικό κλειδί δεν ταιριάζουν |
100025 | Το MIME τύπος εικόνας δεν είναι έγκυρο |
100026 | Το αρχείο πρόσβασης συνδέσμου έχει λήξει |
100027 | Η αίτηση API έχει φτάσει στο όριο |
100028 | Η λειτουργία πολλαπλών πράξεων είναι ανοιχτή μόνο για πληρωμή χρήστες |
100029 | Η σύνδεση εικόνας δεν είναι έγκυρη |
100030 | Ο χρήστης αποτελεί πιθανόν παραβίαση των όρων χρήσης και έχει αποκλειστεί από την είσοδο |
200- Περιγραφή
- Επιτυχία
504- Περιγραφή
- Η αίτηση έχει υπερβεί το χρονικό όριο
999999- Περιγραφή
- Σφάλμα εσωτερικού διακομιστή
100000- Περιγραφή
- Σφάλμα παραμέτρων αίτησης
100001- Περιγραφή
- Η πρόσβαση στο εισιτήριο έχει λήξει
100002- Περιγραφή
- Η ανθρώπινη μηχανική επαλήθευση δεν πέρασε
100003- Περιγραφή
- Το επαληθευτικό κωδικό δεν είναι σωστός
100004- Περιγραφή
- Το χρήστη δεν υπάρχει
100005- Περιγραφή
- Οι λογαριασμοί δεν ταιριάζουν
100006- Περιγραφή
- Το πρόγραμμα συνδρομής δεν υπάρχει
100007- Περιγραφή
- SMS/E-posta gönderimi çok sık
100008- Περιγραφή
- SMS/E-posta gönderimi çok sık
100009- Περιγραφή
- Alan/Depolama kabı bulunamadı
100010- Περιγραφή
- Alan/Depolama kabı mevcut
100011- Περιγραφή
- Alan/Depolama kabı dolu değil
100012- Περιγραφή
- Η λειτουργία είναι πολύ συχνή
100013- Περιγραφή
- Alan/Depolama kabı sayısı kotası doldu
100014- Περιγραφή
- Alan/Depolama kabı sayısı kotası doldu
100015- Περιγραφή
- Το ρεύμα μεταφοράς έχει καταναλωθεί
100016- Περιγραφή
- Το πρόγραμμα συνδρομής δεν ταιριάζει
100017- Περιγραφή
- Alan/Depolama kabı dosya erişimi kısıtlı
100018- Περιγραφή
- Το αρχείο υπερβαίνει το όριο μεγέθους
100019- Περιγραφή
- Το μορφοποίηση αρχείου δεν υποστηρίζεται
100020- Περιγραφή
- Referer izni yok
100021- Περιγραφή
- Η λειτουργία είναι ανοιχτή μόνο για Pro ή Premium χρήστες
100022- Περιγραφή
- Η λειτουργία είναι ανοιχτή μόνο για Premium χρήστες
100023- Περιγραφή
- Το πιστοποιητικό περιεχόμενο δεν είναι έγκυρο
100024- Περιγραφή
- Το πιστοποιητικό και το ιδιωτικό κλειδί δεν ταιριάζουν
100025- Περιγραφή
- Το MIME τύπος εικόνας δεν είναι έγκυρο
100026- Περιγραφή
- Το αρχείο πρόσβασης συνδέσμου έχει λήξει
100027- Περιγραφή
- Η αίτηση API έχει φτάσει στο όριο
100028- Περιγραφή
- Η λειτουργία πολλαπλών πράξεων είναι ανοιχτή μόνο για πληρωμή χρήστες
100029- Περιγραφή
- Η σύνδεση εικόνας δεν είναι έγκυρη
100030- Περιγραφή
- Ο χρήστης αποτελεί πιθανόν παραβίαση των όρων χρήσης και έχει αποκλειστεί από την είσοδο
SDK
Το StarDots παρέχει SDKs για διάφορες γλώσσες προγραμματισμού για να σας βοηθήσει να ενσωματώσετε γρήγορα την API μας. Μπορείτε να βρείτε τα SDKs στους παρακάτω συνδέσμους:
GoJavaC#PythonTypescriptC++RustPHPRubyVSwiftKotlinDart