IPFS Ninja

Faça upload facilmente de imagens, PDFs e arquivos JSON para o IPFS e obtenha um identificador de conteúdo permanente (CID) com acesso instantâneo via gateway.

O que é IPFS?

O Sistema de Arquivos Interplanetário (IPFS) é um protocolo de armazenamento descentralizado ponto a ponto. O IPFS divide os arquivos em pedaços menores, distribui-os pela rede e atribui a cada arquivo um identificador de conteúdo (CID) único baseado em seu conteúdo.

Isso significa:

• Armazenamento distribuído — seus arquivos são armazenados em múltiplos nós para maior confiabilidade.
• Endereçamento por conteúdo — o CID é derivado do próprio conteúdo do arquivo, garantindo imutabilidade.
• Acessibilidade em toda a rede — qualquer pessoa com o CID pode recuperar o arquivo de qualquer no IPFS.

O que o IPFS Ninja faz

IPFS Ninja é um serviço gerenciado que permite fazer upload de arquivos e fixar conteúdo existente no IPFS através de uma API REST simples. Não é necessnecessário executar seu próprio no IPFS.

• Upload de novos arquivos — envie qualquer arquivo via POST /upload/new e obtenha um CID permanente
• Fixar CIDs existentes — já tem conteúdo no IPFS? Fixe-o ao nosso cluster via POST /pin para garantir que permaneca disponível
• Acesso via gateway — todo conteúdo fixado é acessacessível em ipfs.ninja/ipfs/<CID> (o gateway apex serve apenas CIDs da sua conta ou de outras contas IPFS Ninja — veja Acesso ao gateway abaixo)
• Metadados personalizados — anexe pares chave-valor a uploads e fixações para organização e filtragem
• Tokens de upload assinados — gere tokens com tempo limitado para uploads do lado do cliente sem expor sua chave API
• Nomes mutaveis IPNS — crie nomes estaveis que apontam para CIDs diferentes ao longo do tempo via API IPNS, com até 10 nomes por conta
• Otimização de imagens — redimensione, converta e comprima imagens em tempo real via parâmetros de URL do gateway

Painel de Controle

Acompanhe uploads, armazenamento e largura de banda do gateway no seu painel de controle pessoal.

Acesso ao gateway

Cada arquivo enviado é acessacessível através do gateway IPFS Ninja, que atua como ponte entre a rede descentralizada IPFS e os navegadores web tradicionais.

A URL do gateway segue este padrão:

https://ipfs.ninja/ipfs/<CID>

Escopo do gateway apex

O gateway apex em https://ipfs.ninja/ipfs/<CID> serve apenas CIDs que tenham sido enviados ou fixados por um usuário registrado do IPFS Ninja. Solicitações para qualquer outro CID retornam HTTP 410 Gone com um ponteiro para gateways IPFS públicos como ipfs.io ou dweb.link. Para servir um CID de terceiros através do nosso gateway, cadastre-se grátis e faça primeiro POST /pin para sua conta.

TIP

Seus arquivos também são acessíveis a partir de qualquer gateway IPFS público (ex.: dweb.link, w3s.link) usando o mesmo CID — a rede IPFS e descentralizada.

Usuarios do plano Nirvana recebem um gateway dedicado em seu próprio subdominio (<slug>.gw.ipfs.ninja) que serve apenas arquivos fixados em sua conta — com controle de acesso opcional baseado em tokens e restrições de origem.

Tipos de arquivo suportados

Tipo	Formatos	Entrada
JSON	Qualquer objeto ou array JSON válido	string / object
Imagens	PNG, JPG, WebP, GIF, TIFF, SVG	base64
PDFs	Documentos PDF padrão	base64
HTML	Documentos HTML	base64
Qualquer	Qualquer arquivo (binario, texto, video, etc.)	base64

Todos os tipos de arquivo são aceitos. O tipo é detectdetectado automaticamente é registrregistrado para sua referência.

Segurança

As respostas do gateway incluem cabeçalhos de segurança (Content-Security-Policy: sandbox, X-Content-Type-Options: nosniff, X-Frame-Options: DENY) que impedem os navegadores de executar scripts no conteúdo servido.