คำถามที่พบบ่อย

คำถามที่พบบ่อยเกี่ยวกับ 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 ที่ถูกต้อง ใดก็ได้ คลัสเตอร์ของเราจะดึงเนื้อหาจากเครือข่าย IPFS และปักหมุดไว้ในบัญชีของคุณ ดูรายละเอียดที่ เอกสาร Pinning API

การปักหมุดใช้เวลานานเท่าไร?

ขึ้นอยู่กับขนาดไฟล์และจำนวนโหนด IPFS ที่มีเนื้อหา ไฟล์ขนาดเล็กที่กระจายดีจะปักหมุดได้ในไม่กี่วินาที เนื้อหาขนาดใหญ่หรือที่ถูกปักหมุดน้อยอาจใช้เวลาไม่กี่นาที endpoint การปักหมุดจะตอบกลับทันทีด้วยสถานะ pinning — สอบถาม GET /pin/:cid เพื่อตรวจสอบความคืบหน้า

จะเกิดอะไรขึ้นหาก CID ไม่พบ?

สถานะจะเปลี่ยนเป็น failed ซึ่งหมายความว่า CID ไม่ถูกต้องหรือเนื้อหาไม่สามารถใช้งานได้จากโหนด IPFS ที่เข้าถึงได้อีกต่อไป

ข้อมูลที่อัปโหลดไปยัง IPFS เป็นสาธารณะหรือไม่?

ใช่ เนื้อหาทั้งหมดที่ปักหมุดบน IPFS สามารถเข้าถึงได้สาธารณะผ่าน CID ผ่าน IPFS gateway ใดก็ได้ หากคุณต้องการการเข้าถึงแบบส่วนตัว ใช้ gateway เฉพาะ ด้วยโหมดต้องใช้โทเค็น — ซึ่งจำกัดการเข้าถึงผ่าน gateway ของคุณ แม้ว่าเนื้อหาจะยังคงใช้งานได้บนเครือข่าย IPFS ที่กว้างกว่า

ไฟล์ของฉันจะยังคงอยู่บน IPFS หากฉันยกเลิกบัญชีหรือไม่?

เราจะถอนปักหมุดไฟล์ของคุณจากโหนดของเราเมื่อคุณยกเลิก หากโหนด IPFS อื่นๆ ได้แคชเนื้อหาของคุณไว้ มันอาจยังคงเข้าถึงได้ อย่างไรก็ตาม หากไม่มีการปักหมุดที่ใช้งานอยู่ ไฟล์จะถูกลบออกโดย garbage collection ในที่สุดทั่วทั้งเครือข่าย

การยืนยันตัวตนและ API

ฉันจะยืนยันตัวตนคำขอ API ได้อย่างไร?

ส่ง API key ของคุณผ่านเฮดเดอร์ 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 ปลอดภัยในการฝังในแอปฝั่งหน้า

Gateway เฉพาะ

Gateway เฉพาะคืออะไร?

Gateway IPFS ส่วนตัวที่ซับโดเมนของคุณเอง (เช่น abc123.gw.ipfs.ninja) ที่ให้บริการเฉพาะไฟล์ที่ปักหมุดในบัญชีของคุณ ต่างจาก gateway สาธารณะ จะไม่แก้ไข CID จากผู้ใช้อื่น

แผนไหนรวม gateway เฉพาะ?

Gateway เฉพาะมีให้ในแผน Nirvana ($29/เดือน) ซึ่งรวมแบนด์วิดท์ gateway 50 GB/เดือน

ฉันสามารถจำกัดผู้ที่เข้าถึง gateway ของฉันได้หรือไม่?

ได้ คุณสามารถเปิดใช้โหมดต้องใช้โทเค็น (ต้องมีโทเค็น gwt_ ในทุกคำขอ) และ/หรือตั้ง IP whitelist (สูงสุด 100 ที่อยู่)

ฉันสามารถจำกัด gateway ตาม origin/domain ได้หรือไม่?

ได้ กำหนดค่า allowedOrigins ในการตั้งค่า gateway ของคุณด้วยรายการ HTTPS origin เฉพาะคำขอจากเบราว์เซอร์จาก origin เหล่านั้นเท่านั้นที่จะได้รับอนุญาต คำขอที่ไม่ใช่เบราว์เซอร์ (ไม่มีเฮดเดอร์ Origin) จะผ่านไปได้ รายการว่างอนุญาตทุก origin

โทเค็นอัปโหลดที่ลงนามคืออะไร?

โทเค็นอัปโหลดที่ลงนามเป็นข้อมูลรับรองที่มีระยะเวลาจำกัดสำหรับการอัปโหลดฝั่งไคลเอนต์ คุณสร้างมันบนเซิร์ฟเวอร์ของคุณโดยใช้ POST /upload/signed-url และส่งให้เบราว์เซอร์หรือแอปมือถือ ไคลเอนต์ยืนยันตัวตนด้วย Authorization: Signed <token> แทนที่จะเปิดเผย API key ของคุณ แต่ละโทเค็นจะติดตามการใช้งานและหมดอายุโดยอัตโนมัติ ดูรายละเอียดที่ เอกสารโทเค็นที่ลงนาม

ฉันสามารถปรับแต่งรูปภาพที่ให้บริการจาก IPFS ได้หรือไม่?

ได้ ใช้ GET /image/:cid พร้อมพารามิเตอร์คิวรีเช่น w, h, format และ quality เพื่อปรับขนาด แปลง และบีบอัดรูปภาพแบบ on-the-fly การตอบกลับจะถูกแคชตาม CID ที่ระบุด้วยเนื้อหา ใช้งานได้ในทุกแผน ดู การปรับแต่งรูปภาพ

ฉันสามารถแนบ metadata กับไฟล์ได้หรือไม่?

ได้ รวมอ็อบเจกต์ metadata พร้อมคู่คีย์-ค่าสูงสุด 10 คู่เมื่ออัปโหลดผ่าน POST /upload/new หรือปักหมุดผ่าน POST /pin metadata จะถูกส่งคืนในรายการไฟล์และ endpoint รายละเอียดไฟล์ ดูเอกสาร ไฟล์ และ การปักหมุด

การเรียกเก็บเงินและแผน

มีแผนฟรีหรือไม่?

มี แผน 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 ในโค้ดฝั่งเซิร์ฟเวอร์?

ปลอดภัย API key ถูกออกแบบมาสำหรับการใช้งานฝั่งเซิร์ฟเวอร์ อย่าเปิดเผยในโค้ดฝั่งไคลเอนต์ สำหรับการเข้าถึงไฟล์ฝั่งไคลเอนต์ ใช้ gateway token (gwt_) ซึ่งเป็นแบบอ่านอย่างเดียว

การสนับสนุน

ฉันจะขอความช่วยเหลือได้อย่างไร?

ส่งอีเมลไปที่ info@ipfs.ninja หรือดูเอกสาร เอกสารอ้างอิง API

มี SLA หรือไม่?

เรามุ่งมั่นให้บริการที่มีความพร้อมใช้งานสูงแต่ไม่ได้เสนอ SLA อย่างเป็นทางการในขณะนี้ บริการนี้ให้บริการ "ตามสภาพ"