IPFS Ninja

Carrega facilmente imagens, PDFs e ficheiros JSON para o IPFS e obtém um identificador de conteúdo permanente (CID) com acesso instantâneo via gateway.

O que é o IPFS?

O InterPlanetary File System (IPFS) é um protocolo de armazenamento descentralizado, ponto a ponto. O IPFS divide os ficheiros em pedaços mais pequenos, distribui-os pela rede, e atribui a cada ficheiro um identificador de conteúdo (CID) único com base no seu conteúdo.

Isto significa:

• Armazenamento distribuído — os teus ficheiros são guardados em vários nós para maior fiabilidade.
• Endereçamento por conteúdo — o CID é derivado do próprio conteúdo do ficheiro, garantindo imutabilidade.
• Acessibilidade em toda a rede — qualquer pessoa com o CID pode obter o ficheiro a partir de qualquer nó IPFS.

O que faz o IPFS Ninja

O IPFS Ninja é um serviço gerido que te permite carregar ficheiros e fixar conteúdo existente no IPFS através de uma API REST simples. Sem necessidade de correr o teu próprio nó IPFS.

• Carregar novos ficheiros — envia qualquer ficheiro via POST /upload/new e recebe um CID permanente
• Fixar CIDs existentes — já tens conteúdo no IPFS? Fixa-o ao nosso cluster via POST /pin para garantir que se mantém disponível
• Acesso via gateway — todo o conteúdo fixado está acessível em ipfs.ninja/ipfs/<CID> (o gateway apex só serve CIDs da tua conta ou de outras contas IPFS Ninja — ver Acesso ao gateway abaixo)
• Metadados personalizados — anexa pares chave-valor a carregamentos e fixações para organização e filtragem
• Tokens de carregamento assinados — gera tokens com tempo limitado para carregamentos do lado do cliente sem expor a tua chave de API
• Nomes mutáveis IPNS — cria nomes estáveis que apontam para CIDs que mudam via API IPNS, com até 10 nomes por conta
• Otimização de imagens — redimensiona, converte e comprime imagens em tempo real via parâmetros de URL do gateway

Painel

Acompanha carregamentos, armazenamento e largura de banda do gateway no teu painel pessoal. O painel também te permite operar a maior parte da API sem escrever código:

• Carregamento por arrastar e largar — ficheiros, pastas (agrupadas num diretório UnixFS no teu browser), ou arquivos .car
• Muda o nome de ficheiros depois de carregados; a descrição preenche-se automaticamente a partir do nome do ficheiro ao selecionares
• Cria um instantâneo de uma pasta para obter um único CID de diretório para tudo o que está lá dentro
• Configura CORS S3 por bucket através de um editor de formulário (para integrações via SDK no browser)
• Gere chaves de API, tokens de gateway, nomes IPNS, e configurações de gateway dedicado

Acesso ao gateway

Cada ficheiro carregado fica acessível através do gateway IPFS Ninja, que atua como ponte entre a rede descentralizada IPFS e os browsers web tradicionais.

O URL do gateway segue este padrão:

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

Âmbito do gateway apex

O gateway apex em https://ipfs.ninja/ipfs/<CID> só serve CIDs que tenham sido carregados ou fixados por um utilizador registado do IPFS Ninja. Os pedidos para qualquer outro CID devolvem HTTP 410 Gone com um apontador para gateways IPFS públicos como ipfs.io ou dweb.link. Para servir um CID de terceiros através do nosso gateway, regista-te grátis e faz primeiro POST /pin para a tua conta.

TIP

Os teus ficheiros 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 no seu próprio subdomínio (<slug>.gw.ipfs.ninja) que só serve ficheiros fixados na sua conta — com controlo de acesso opcional por token e restrições de origem. O gateway dedicado é o URL recomendado para incorporação em produção (vídeos, visualizadores de NFT, sites).

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

Todos os tipos de ficheiro são aceites. O tipo é detetado automaticamente e registado para tua 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 browsers de executar scripts no conteúdo servido.