Gateways Dedicats

Els usuaris del pla Nirvana obtenen un gateway IPFS privat a un subdomini unic. Aquest gateway nomes serveix fitxers fixats al vostre compte — no resoldrà CID d'altres usuaris o de la xarxa IPFS publica.

El vostre URL de gateway

El vostre URL de gateway es mostra a la vostra pagina de Gateway i es retorna per l'endpoint /user/profile:

https://<your-slug>.gw.ipfs.ninja/ipfs/<CID>

Modes d'acces

Mode	Comportament
Obert (per defecte)	Qualsevol persona amb el vostre URL de gateway + CID pot accedir als vostres fitxers. No cal token.
Token requerit	Les sol·licituds han d'incloure un gateway token mitjançant el parametre de consulta ?token=gwt_... o la capçalera X-Gateway-Token.

Limits

• 50 GB/mes d'amplada de banda de gateway inclosa amb Nirvana
• Quan s'assoleix el limit, les sol·licituds de gateway retornen 429 fins al mes seguent
• L'us d'emmagatzematge es reinicia el primer de cada mes
• Nomes serveix CID fixats al vostre compte — les sol·licituds per altres CID retornen 403

TIP

El gateway public a ipfs.ninja/ipfs/ segueix disponible en tots els plans i serveix qualsevol CID sense autenticacio.

Configuracio del Gateway

Configureu els controls d'acces per al vostre gateway dedicat.

Actualitzar Configuracio

PUT /gateway-settings

Parametre	Tipus	Requerit	Descripcio
tokenRequired	boolean	No	Activar/desactivar el requisit de gateway token.
ipWhitelist	string[]	No	Matriu d'adreces IP permeses. Max 100. Una matriu buida elimina la whitelist.
allowedOrigins	string[]	No	Matriu d'origens permesos per a sol·licituds de navegador. Max 100. Han de ser en format HTTPS (p. ex. https://myapp.com). Una matriu buida permet tots els origens.

Exemples

curl -X PUT https://api.ipfs.ninja/gateway-settings \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"tokenRequired": true}'

curl -X PUT https://api.ipfs.ninja/gateway-settings \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"ipWhitelist": ["203.0.113.1", "198.51.100.0"]}'

curl -X PUT https://api.ipfs.ninja/gateway-settings \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"ipWhitelist": []}'

curl -X PUT https://api.ipfs.ninja/gateway-settings \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"allowedOrigins": ["https://myapp.com", "https://staging.myapp.com"]}'

curl -X PUT https://api.ipfs.ninja/gateway-settings \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"allowedOrigins": []}'

Restriccions d'Origin

Quan allowedOrigins esta configurat, nomes les sol·licituds de navegador des dels origens llistats son permeses. El gateway comprova les capçaleres Origin i Referer.

• Si la llista es buida (per defecte), tots els origens son permesos.
• Si s'especifiquen origens, les sol·licituds amb capçalera Origin o Referer que no coincideixi son rebutjades amb resposta 403.
• Les sol·licituds que no son de navegador sense capçalera Origin passen sense restriccio.

Gateway Tokens

Els gateway token (prefix gwt_) son de nomes lectura i segurs per incrustar en aplicacions frontend.

Capacitat	API Key (bws_)	Gateway Token (gwt_)
Pujar / eliminar fitxers	Si	No
Llistar / obtenir metadata de fitxers	Si	No
Llegir fitxers via gateway	No	Si
Segur per incrustar al frontend	No	Si

Crear Gateway Token

POST /gateway-tokens

Parametre	Tipus	Requerit	Descripcio
name	string	No	Etiqueta per al token (p. ex. "Frontend"). Per defecte "Default".

Resposta 201 Created

{
  "token": "gwt_a1b2c3d4e5f6789012345678abcdef01",
  "tokenPrefix": "gwt_a1b2c3d4",
  "tokenName": "Frontend",
  "createdAt": 1711036800000
}

WARNING

El token complet nomes es retorna una vegada en la creacio. Emmagatzemeu-lo de forma segura.

Llistar Gateway Tokens

GET /gateway-tokens

[
  {
    "tokenPrefix": "gwt_a1b2c3d4",
    "tokenName": "Frontend",
    "createdAt": 1711036800000
  }
]

Eliminar Gateway Token

DELETE /gateway-tokens/:prefix

Parametre	Tipus	Requerit	Descripcio
prefix	string	Si	El prefix del token a eliminar (p. ex. "gwt_a1b2c3d4").

Usar un gateway token

curl "https://a1b2c3d4.gw.ipfs.ninja/ipfs/QmXk7VRz...?token=gwt_your_token"

curl https://a1b2c3d4.gw.ipfs.ninja/ipfs/QmXk7VRz... \
  -H "X-Gateway-Token: gwt_your_token"