BUJ

Bieži uzdotie jautājumi par IPFS Ninja.

Vispārīgi

Kas ir IPFS Ninja?

IPFS Ninja ir pārvaldīts IPFS piespraušanas pakalpojums. Jūs augšupielādējat jebkuru failu caur vienkāršu REST API vai piespraužat esošus CID no IPFS tīkla. Katrs fails saņem pastāvīgu satura identifikatoru (CID) un ir pieejams caur mūsu gateway ipfs.ninja/ipfs/<CID>.

Kādi failu tipi tiek atbalstīti?

Visi failu tipi tiek atbalstīti. JSON objektus un masīvus var nosūtīt tieši. Visi citi faili (attēli, PDF, HTML, video, audio, binārie) tiek nosūtīti kā base64 kodēts saturs.

Vai ir faila izmēra ierobežojums?

Individuālās augšupielādes ierobežo jūsu plāna glabāšanas kvota. Nav atsevišķa faila izmēra ierobežojuma papildus jūsu pieejamajai glabātuvei.

Vai es varu piespraust saturu, kas jau pastāv IPFS?

Jā. Izmantojiet POST /pin ar jebkuru derīgu CID. Mūsu klasteris iegūst saturu no IPFS tīkla un piespauž to jūsu kontam. Skatiet Pinning API dokumentāciju detaļām.

Cik ilgi aizņem piespraušana?

Tas ir atkarīgs no faila izmēra un tā, cik daudziem IPFS mezgliem ir saturs. Mazi, labi izplatīti faili tiek piesprausti sekundēs. Liels vai reti piesprausts saturs var aizņemt dažas minūtes. Piespraušanas galapunkts atgriežas nekavējoties ar statusu pinning — aptaujājiet GET /pin/:cid, lai pārbaudītu progresu.

Kas notiek, ja CID nevar atrast?

Statuss mainās uz failed. Tas nozīmē, ka CID ir nederīgs vai saturs vairs nav pieejams nevienā sasniedzamā IPFS mezglā.

Vai uz IPFS augšupielādētie dati ir publiski?

Jā. Viss IPFS piespraustais saturs ir publiski pieejams caur tā CID jebkurā IPFS gateway. Ja jums nepieciešama privāta piekļuve, izmantojiet veltītu gateway ar tokenu nepieciešamības režīmu — tas ierobežo piekļuvi caur jūsu gateway, lai gan saturs paliek pieejams plašākā IPFS tīklā.

Vai mani faili paliks IPFS, ja es atcelšu savu kontu?

Mēs atceļam jūsu failu piespraušanu no mūsu mezgliem, kad jūs atceļat. Ja citi IPFS mezgli ir kešojuši jūsu saturu, tas var palikt pieejams. Tomēr bez aktīvas piespraušanas faili galu galā tiks noņemti ar atkritumu savākšanu visā tīklā.

Autentifikācija & API

Kā autentificēt API pieprasījumus?

Nosūtiet savu API atslēgu caur X-Api-Key galveni. Ģenerējiet atslēgas no API atslēgu lapas savā informācijas panelī.

Vai ir API ātruma ierobežojumi?

Nē. IPFS Ninja neuzliek ātruma ierobežojumus API pieprasījumiem. Jūs varat veikt tik daudz pieprasījumu, cik nepieciešams, jebkurā plānā.

Vai API atslēgas beidzas?

Nē. API atslēgas ir derīgas, līdz tās izdzēšat. Varat izveidot vairākas atslēgas un atsaukt tās atsevišķi.

Kāda ir atšķirība starp API atslēgām un gateway tokeniem?

API atslēgām (bws_) ir pilna piekļuve — augšupielādēt, dzēst, uzskaitīt failus. Gateway tokeni (gwt_) ir tikai lasīšanai un var piekļūt failiem tikai caur jūsu veltīto gateway. Gateway tokenus ir droši iekļaut frontend lietotnēs.

Veltīti gateway

Kas ir veltīts gateway?

Privāts IPFS gateway jūsu apakšdomēnā (piemēram, abc123.gw.ipfs.ninja), kas apkalpo tikai jūsu kontam piespraustos failus. Atšķirībā no publiskā gateway, tas neatrisinās CID no citiem lietotājiem.

Kuri plāni ietver veltītu gateway?

Veltīti gateway ir pieejami Nirvana plānā (29 $/mēn), kas ietver 50 GB/mēnesī gateway joslas platumu.

Vai es varu ierobežot, kas piekļūst manam gateway?

Jā. Varat iespējot tokenu nepieciešamības režīmu (nepieciešams gwt_ tokens katrā pieprasījumā) un/vai iestatīt IP balto sarakstu (līdz 100 adresēm).

Vai es varu ierobežot savu gateway pēc izcelsmes/domēna?

Jā. Konfigurējiet allowedOrigins savos gateway iestatījumos ar HTTPS izcelsmju sarakstu. Tiek atļauti tikai pārlūkprogrammas pieprasījumi no šīm izcelsmēm. Pieprasījumi bez pārlūkprogrammas (bez Origin galvenes) tiek izlaisti. Tukšs saraksts atļauj visas izcelsmes.

Kas ir parakstīti augšupielādes tokeni?

Parakstīti augšupielādes tokeni ir laika ierobežoti akreditācijas dati klienta puses augšupielādēm. Jūs tos ģenerējat savā serverī, izmantojot POST /upload/signed-url, un nododat tos pārlūkprogrammām vai mobilajām lietotnēm. Klients autentificējas ar Authorization: Signed <token>, nevis atklājot jūsu API atslēgu. Katrs tokens izseko lietošanu un beidzas automātiski. Skatiet parakstīto tokenu dokumentāciju detaļām.

Vai es varu optimizēt attēlus, kas tiek apkalpoti no IPFS?

Jā. Izmantojiet GET /image/:cid ar vaicājuma parametriem kā w, h, format un quality, lai mainītu izmēru, konvertētu un saspiestu attēlus lidojumā. Atbildes tiek kešotas, pamatojoties uz satura adresēto CID. Tas darbojas visos plānos. Skatiet Attēlu optimizācija.

Vai es varu pievienot metadatus failiem?

Jā. Iekļaujiet metadata objektu ar līdz 10 atslēgu-vērtību pāriem, augšupielādējot caur POST /upload/new vai piespraužot caur POST /pin. Metadati tiek atgriezti failu sarakstos un faila detaļu galapunktā. Skatiet Faili un Piespraušana dokumentāciju.

Norēķini & Plāni

Vai ir bezmaksas plāns?

Jā. Dharma plāns ir bezmaksas mūžīgi — 1 GB glabātuves, neierobežoti API pieprasījumi, kredītkarte nav nepieciešama.

Vai ir joslas platuma maksas?

Nav joslas platuma maksu API pieprasījumiem nevienā plānā. Veltīta gateway joslas platums (Nirvana plāns) ietver 50 GB/mēnesī. Kad limits ir sasniegts, gateway pieprasījumi tiek bloķēti līdz nākamajam mēnesim.

Vai glabātuve atiestatās?

Glabātuve neatiestatās. Jūsu plāns ietver kopējo glabātuves kvotu (1 GB / 10 GB / 100 GB). Lai atbrīvotu vietu, dzēsiet failus, kas jums vairs nav nepieciešami. Plāna jaunināšana palielina jūsu kopējo kvotu.

Vai es varu atcelt jebkurā laikā?

Jā. Atceliet savu abonementu caur norēķinu portālu — bez saistībām. Jūsu konts atgriezīsies bezmaksas līmenī, un esošie piespraustie faili paliks pieejami.

Kas notiek ar maniem failiem, ja es pazeminu plānu?

Jūsu faili paliek piesprausti IPFS, bet jūs nevarat augšupielādēt vairāk, ja jūsu pašreizējā izmantošana pārsniedz jaunā plāna glabātuves limitu. Dzēsiet failus, lai atgrieztos zem limita.

Drošība

Vai mani dati ir šifrēti?

Visi dati ir šifrēti pārvadē caur TLS/HTTPS. Autentifikācija izmanto JWT tokenus (Cognito) un droši glabātas API atslēgas. Failu saturs IPFS nav šifrēts miera stāvoklī — IPFS ir publisks tīkls pēc dizaina.

Vai ir droši izmantot API atslēgas manā servera kodā?

Jā. API atslēgas ir paredzētas servera puses lietošanai. Nekad neatklājiet tās klienta puses kodā. Klienta puses failu piekļuvei izmantojiet gateway tokenus (gwt_), kas ir tikai lasīšanai.

Atbalsts

Kā es varu saņemt palīdzību?

Sūtiet e-pastu uz info@ipfs.ninja vai skatiet API atsauci.

Vai ir SLA?

Mēs cenšamies nodrošināt augstu pieejamību, bet pašlaik nepiedāvājam formālu SLA. Pakalpojums tiek sniegts "kāds ir" pamatā.