IPFS Ninja

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

O que é o IPFS?

O InterPlanetary File System (IPFS) é um protocolo de armazenamento descentralizado e ponto a ponto. O IPFS divide os arquivos em pedaços menores, os distribui pela rede e atribui a cada arquivo um identificador de conteúdo (CID) único, baseado no 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 nó IPFS.

O que o IPFS Ninja faz

O IPFS Ninja é um serviço gerenciado que permite enviar arquivos e fixar conteúdo existente no IPFS através de uma API REST simples. Não é necessário rodar seu próprio nó IPFS.

• Envie novos arquivos — envie qualquer arquivo via POST /upload/new e obtenha um CID permanente
• Fixe CIDs existentes — já tem conteúdo no IPFS? Fixe-o no nosso cluster via POST /pin para garantir que ele continue disponível
• Acesso via gateway — todo conteúdo fixado fica acessível em ipfs.ninja/ipfs/<CID> (o gateway apex serve apenas CIDs da sua conta ou de outras contas do 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 de API
• Nomes mutáveis IPNS — crie nomes estáveis que apontam para CIDs que mudam 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

Acompanhe uploads, armazenamento e largura de banda do gateway a partir do seu painel pessoal. O painel também permite usar a maior parte da API sem escrever código:

• Upload por arrastar e soltar — arquivos, pastas (empacotadas em um diretório UnixFS no seu navegador) ou arquivos .car
• Renomeie arquivos após o upload; a descrição é preenchida automaticamente a partir do nome do arquivo ao selecioná-lo
• Gere um snapshot de uma pasta para obter um único CID de diretório para tudo o que está dentro dela
• Configure o CORS S3 por bucket através de um editor em formulário (para integrações via SDK no navegador)
• Gerencie chaves de API, tokens de gateway, nomes IPNS e configurações de gateway dedicado

Acesso ao gateway

Todo arquivo enviado fica acessível através do gateway do IPFS Ninja, que atua como uma 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. Requisiçõ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 gratuitamente e faça primeiro POST /pin dele para sua conta.

TIP

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

Todos os planos pagos recebem um gateway dedicado em seu próprio subdomínio (<slug>.gw.ipfs.ninja) que serve apenas os arquivos fixados naquela conta — com controle de acesso opcional baseado em tokens e restrições de origem. O gateway dedicado é a URL recomendada para incorporação em produção (vídeos, visualizadores de NFT, sites).

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 (binário, texto, vídeo, etc.)	base64

Todos os tipos de arquivo são aceitos. O tipo é detectado automaticamente e registrado 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.