Συχνές Ερωτήσεις

Συχνές ερωτήσεις σχετικά με το IPFS Ninja.

Γενικά

Τι είναι το IPFS Ninja;

Το IPFS Ninja είναι μια διαχειριζόμενη υπηρεσία IPFS pinning. Ανεβάζετε οποιοδήποτε αρχείο μέσω ενός απλού REST API, ή καρφιτσώνετε υπάρχοντα CID από το δίκτυο IPFS. Κάθε αρχείο αποκτά μόνιμο αναγνωριστικό περιεχομένου (CID) και είναι προσβάσιμο μέσω του gateway μας στο ipfs.ninja/ipfs/<CID>.

Ποιοι τύποι αρχείων υποστηρίζονται;

Υποστηρίζονται όλοι οι τύποι αρχείων. Τα JSON αντικείμενα και πίνακες μπορούν να σταλούν απευθείας. Όλα τα άλλα αρχεία (εικόνες, PDF, HTML, βίντεο, ήχος, δυαδικά) στέλνονται ως περιεχόμενο κωδικοποιημένο σε base64.

Υπάρχει όριο μεγέθους αρχείου;

Τα μεμονωμένα ανεβάσματα περιορίζονται από το επίδομα αποθήκευσης του πλάνου σας. Δεν υπάρχει όριο μεγέθους ανά αρχείο πέραν της διαθέσιμης αποθήκευσής σας.

Μπορώ να καρφιτσώσω περιεχόμενο που υπάρχει ήδη στο IPFS;

Ναι. Χρησιμοποιήστε POST /pin με οποιοδήποτε έγκυρο CID. Το cluster μας θα ανακτήσει το περιεχόμενο από το δίκτυο IPFS και θα το καρφιτσώσει στον λογαριασμό σας. Δείτε τα Pinning API docs για λεπτομέρειες.

Πόσο χρόνο παίρνει το καρφίτσωμα;

Εξαρτάται από το μέγεθος του αρχείου και πόσοι κόμβοι IPFS έχουν το περιεχόμενο. Μικρά, καλά κατανεμημένα αρχεία καρφιτσώνονται σε δευτερόλεπτα. Μεγάλο ή σπάνια καρφιτσωμένο περιεχόμενο μπορεί να πάρει μερικά λεπτά. Το endpoint pin επιστρέφει αμέσως με κατάσταση pinning — κάντε poll στο GET /pin/:cid για να ελέγξετε την πρόοδο.

Τι γίνεται αν δεν βρεθεί ένα CID;

Η κατάσταση αλλάζει σε failed. Αυτό σημαίνει ότι το CID είναι μη έγκυρο ή το περιεχόμενο δεν είναι πλέον διαθέσιμο σε κανέναν προσβάσιμο κόμβο IPFS.

Είναι δημόσια τα δεδομένα που ανεβαίνουν στο IPFS;

Ναι. Όλο το περιεχόμενο που καρφιτσώνεται στο IPFS είναι δημόσια προσβάσιμο μέσω του CID του μέσω οποιουδήποτε IPFS gateway. Αν χρειάζεστε ιδιωτική πρόσβαση, χρησιμοποιήστε ένα αποκλειστικό gateway με λειτουργία απαίτησης token — αυτό περιορίζει την πρόσβαση μέσω του gateway σας, αν και το περιεχόμενο παραμένει διαθέσιμο στο ευρύτερο δίκτυο IPFS.

Θα παραμείνουν τα αρχεία μου στο IPFS αν ακυρώσω τον λογαριασμό μου;

Ξεκαρφιτσώνουμε τα αρχεία σας από τους κόμβους μας όταν ακυρώνετε. Αν άλλοι κόμβοι IPFS έχουν αποθηκεύσει προσωρινά το περιεχόμενό σας, μπορεί να παραμείνει προσβάσιμο. Ωστόσο, χωρίς ενεργό καρφίτσωμα, τα αρχεία θα αφαιρεθούν τελικά μέσω garbage collection σε όλο το δίκτυο.

Πιστοποίηση & API

Πώς πιστοποιώ τα αιτήματα API;

Περάστε το API key σας μέσω του header X-Api-Key. Δημιουργήστε κλειδιά από τη σελίδα API Keys στον πίνακα ελέγχου σας.

Υπάρχουν όρια ρυθμού API;

Όχι. Το IPFS Ninja δεν επιβάλλει όρια ρυθμού στα αιτήματα API. Μπορείτε να κάνετε όσα αιτήματα χρειάζεστε σε οποιοδήποτε πλάνο.

Λήγουν τα API key;

Όχι. Τα API key ισχύουν μέχρι να τα διαγράψετε. Μπορείτε να δημιουργήσετε πολλαπλά κλειδιά και να τα ανακαλέσετε μεμονωμένα.

Ποια είναι η διαφορά μεταξύ API key και gateway token;

Τα API key (bws_) έχουν πλήρη πρόσβαση — ανέβασμα, διαγραφή, λίστα αρχείων. Τα gateway token (gwt_) είναι μόνο για ανάγνωση και μπορούν να αποκτήσουν πρόσβαση σε αρχεία μόνο μέσω του αποκλειστικού gateway σας. Τα gateway token είναι ασφαλή για ενσωμάτωση σε εφαρμογές frontend.

Αποκλειστικά Gateways

Τι είναι ένα αποκλειστικό gateway;

Ένα ιδιωτικό IPFS gateway στο δικό σας subdomain (π.χ. abc123.gw.ipfs.ninja) που εξυπηρετεί μόνο αρχεία καρφιτσωμένα στον λογαριασμό σας. Σε αντίθεση με το δημόσιο gateway, δεν θα επιλύσει CID από άλλους χρήστες.

Ποια πλάνα περιλαμβάνουν αποκλειστικό gateway;

Τα αποκλειστικά gateways είναι διαθέσιμα στο πλάνο Nirvana ($29/μήνα), που περιλαμβάνει 50 GB/μήνα εύρος ζώνης gateway.

Μπορώ να περιορίσω ποιος έχει πρόσβαση στο gateway μου;

Ναι. Μπορείτε να ενεργοποιήσετε τη λειτουργία απαίτησης token (απαιτεί token gwt_ σε κάθε αίτημα) και/ή να ορίσετε IP whitelist (έως 100 διευθύνσεις).

Μπορώ να περιορίσω το gateway μου ανά origin/domain;

Ναι. Ρυθμίστε το allowedOrigins στις ρυθμίσεις gateway σας με λίστα HTTPS origins. Μόνο αιτήματα browser από αυτές τις πηγές θα επιτρέπονται. Αιτήματα εκτός browser (χωρίς header Origin) περνούν χωρίς περιορισμό. Κενή λίστα επιτρέπει όλες τις πηγές.

Τι είναι τα υπογεγραμμένα token ανεβάσματος;

Τα υπογεγραμμένα token ανεβάσματος είναι διαπιστευτήρια περιορισμένου χρόνου για ανεβάσματα από πλευρά πελάτη. Τα δημιουργείτε στον server σας χρησιμοποιώντας POST /upload/signed-url και τα περνάτε σε browsers ή εφαρμογές κινητών. Ο πελάτης πιστοποιείται με Authorization: Signed <token> αντί να εκθέτει το API key σας. Κάθε token παρακολουθεί τη χρήση και λήγει αυτόματα. Δείτε τα Signed Tokens docs για λεπτομέρειες.

Μπορώ να βελτιστοποιήσω εικόνες που εξυπηρετούνται από το IPFS;

Ναι. Χρησιμοποιήστε GET /image/:cid με παραμέτρους ερωτήματος όπως w, h, format και quality για αλλαγή μεγέθους, μετατροπή και συμπίεση εικόνων on-the-fly. Οι απαντήσεις αποθηκεύονται στην cache βάσει του CID. Αυτό λειτουργεί σε όλα τα πλάνα. Δείτε Βελτιστοποίηση Εικόνας.

Μπορώ να επισυνάψω metadata σε αρχεία;

Ναι. Συμπεριλάβετε ένα αντικείμενο metadata με έως 10 ζεύγη κλειδιού-τιμής κατά το ανέβασμα μέσω POST /upload/new ή το καρφίτσωμα μέσω POST /pin. Τα metadata επιστρέφονται στις λίστες αρχείων και στο endpoint λεπτομερειών αρχείου. Δείτε τα docs Αρχεία και Καρφίτσωμα.

Χρεώσεις & Πλάνα

Υπάρχει δωρεάν πλάνο;

Ναι. Το πλάνο Dharma είναι δωρεάν για πάντα — 1 GB αποθήκευσης, απεριόριστα αιτήματα API, δεν απαιτείται πιστωτική κάρτα.

Υπάρχουν χρεώσεις εύρους ζώνης;

Χωρίς χρεώσεις εύρους ζώνης σε αιτήματα API για οποιοδήποτε πλάνο. Το εύρος ζώνης αποκλειστικού gateway (πλάνο Nirvana) περιλαμβάνει 50 GB/μήνα. Όταν φτάσει το όριο, τα αιτήματα gateway αποκλείονται μέχρι τον επόμενο μήνα.

Γίνεται επαναφορά αποθήκευσης;

Η αποθήκευση δεν γίνεται επαναφορά. Το πλάνο σας περιλαμβάνει συνολικό επίδομα αποθήκευσης (1 GB / 10 GB / 100 GB). Για να ελευθερώσετε χώρο, διαγράψτε αρχεία που δεν χρειάζεστε πλέον. Η αναβάθμιση του πλάνου σας αυξάνει το συνολικό επίδομά σας.

Μπορώ να ακυρώσω ανά πάσα στιγμή;

Ναι. Ακυρώστε τη συνδρομή σας μέσω της πύλης χρέωσης — χωρίς δέσμευση. Ο λογαριασμός σας επιστρέφει στο δωρεάν επίπεδο και τα καρφιτσωμένα αρχεία παραμένουν προσβάσιμα.

Τι γίνεται με τα αρχεία μου αν υποβαθμίσω;

Τα αρχεία σας παραμένουν καρφιτσωμένα στο IPFS, αλλά δεν μπορείτε να ανεβάσετε περισσότερα αν η τρέχουσα χρήση σας υπερβαίνει το όριο αποθήκευσης του νέου πλάνου. Διαγράψτε αρχεία για να επιστρέψετε κάτω από το όριο.

Ασφάλεια

Είναι κρυπτογραφημένα τα δεδομένα μου;

Όλα τα δεδομένα κρυπτογραφούνται κατά τη μεταφορά μέσω TLS/HTTPS. Η πιστοποίηση χρησιμοποιεί JWT token (Cognito) και API key που αποθηκεύονται με ασφάλεια. Το περιεχόμενο αρχείων στο IPFS δεν κρυπτογραφείται σε κατάσταση ηρεμίας — το IPFS είναι δημόσιο δίκτυο εκ σχεδιασμού.

Είναι ασφαλές να χρησιμοποιώ API key στον server-side κώδικά μου;

Ναι. Τα API key σχεδιάστηκαν για χρήση στην πλευρά του server. Μην τα εκθέτετε ποτέ σε κώδικα client-side. Για πρόσβαση αρχείων στην πλευρά του πελάτη, χρησιμοποιήστε gateway token (gwt_) που είναι μόνο για ανάγνωση.

Υποστήριξη

Πώς μπορώ να λάβω βοήθεια;

Στείλτε email στο info@ipfs.ninja ή ελέγξτε την τεκμηρίωση Αναφορά API.

Υπάρχει SLA;

Προσπαθούμε για υψηλή διαθεσιμότητα αλλά δεν προσφέρουμε επίσημο SLA αυτή τη στιγμή. Η υπηρεσία παρέχεται σε βάση "ως έχει".