Γρήγορη Εκκίνηση

Ανεβάστε το πρώτο σας αρχείο στο IPFS σε λιγότερο από δύο λεπτά.

1. Αποκτήστε το API key σας

Εγγραφείτε στο ipfs.ninja με τον λογαριασμό Google σας. Ένα προεπιλεγμένο API key δημιουργείται αυτόματα. Μεταβείτε στη σελίδα Προφίλ σας για να δείτε και να διαχειριστείτε τα API key σας.

WARNING

Σημείωση: Τα API key δεν λήγουν. Μπορείτε να δημιουργήσετε πολλαπλά κλειδιά και να τα ανακαλέσετε μεμονωμένα από τη σελίδα Προφίλ σας.

2. Ανεβάστε ένα αρχείο

Στείλτε ένα αίτημα POST στο /upload/new με το περιεχόμενό σας. Ακολουθεί ένα παράδειγμα ανεβάσματος ενός JSON αντικειμένου:

curl

curl -X POST https://api.ipfs.ninja/upload/new \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": {
      "name": "My NFT",
      "description": "A permanent file on IPFS",
      "image": "ipfs://QmExampleCID..."
    },
    "description": "NFT metadata"
  }'

JavaScript

const response = await fetch("https://api.ipfs.ninja/upload/new", {
  method: "POST",
  headers: {
    "X-Api-Key": "bws_your_api_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    content: {
      name: "My NFT",
      description: "A permanent file on IPFS",
      image: "ipfs://QmExampleCID..."
    },
    description: "NFT metadata"
  })
});

const data = await response.json();
console.log(data.cid);       // "QmXmCX9S6ANV..."
console.log(data.uris.url);  // "https://ipfs.ninja/ipfs/QmXmCX9S6ANV..."

Το API επιστρέφει το CID, το μέγεθος αρχείου και τα URI πρόσβασης:

{
  "cid": "QmXmCX9S6ANVjYJh3rJmXjqgYtYv7WZLUDL2XCwdPrvUwN",
  "sizeMB": 0.001,
  "uris": {
    "ipfs": "ipfs://QmXmCX9S6ANVjYJh3rJmXjqgYtYv7WZLUDL2XCwdPrvUwN",
    "url": "https://ipfs.ninja/ipfs/QmXmCX9S6ANVjYJh3rJmXjqgYtYv7WZLUDL2XCwdPrvUwN"
  }
}

3. Ανακτήστε το αρχείο σας

Αποκτήστε πρόσβαση στο αρχείο σας με δύο τρόπους:

Μέσω του IPFS gateway (δημόσιο, χωρίς πιστοποίηση)

curl https://ipfs.ninja/ipfs/QmXmCX9S6ANVjYJh3rJmXjqgYtYv7WZLUDL2XCwdPrvUwN

Μέσω του API (επιστρέφει metadata αρχείου)

curl https://api.ipfs.ninja/file/QmXmCX9S6ANVjYJh3rJmXjqgYtYv7WZLUDL2XCwdPrvUwN \
  -H "X-Api-Key: bws_your_api_key_here"

Απάντηση:

{
  "cid": "QmXmCX9S6ANVjYJh3rJmXjqgYtYv7WZLUDL2XCwdPrvUwN",
  "fileName": "NFT metadata",
  "fileType": "json",
  "sizeMB": 0.001,
  "createdAt": 1711036800000,
  "uris": {
    "ipfs": "ipfs://QmXmCX9S6ANVjYJh3rJmXjqgYtYv7WZLUDL2XCwdPrvUwN",
    "url": "https://ipfs.ninja/ipfs/QmXmCX9S6ANVjYJh3rJmXjqgYtYv7WZLUDL2XCwdPrvUwN"
  }
}

Επόμενα βήματα

• Αναφορά API — Πλήρης τεκμηρίωση για όλα τα endpoints, παραμέτρους και κωδικούς σφαλμάτων.
• Αποκλειστικά Gateways — Αποκτήστε ιδιωτικό gateway που εξυπηρετεί μόνο τα αρχεία σας. Διαθέσιμο στο πλάνο Nirvana.