Gestión de metadatos de colecciones
Cómo almacenar archivos multimedia usando la API de Sequence Collections con Cloudflare Workers, así como leer desde la Metadata API para mostrar imágenes.
Tiempo estimado: 20 minutos
En esta guía le mostraremos cómo almacenar archivos multimedia usando la API de Sequence Collections con Cloudflare Workers, así como leer desde la Metadata API para mostrar imágenes.
Esto se puede lograr en 8 pasos
- Obtenga una clave API secreta desde el Sequence Builder Console
- Cree una colección mediante una solicitud cURL una sola vez
- Cree un token usando un tokenID
- Cree un asset usando un assetID
- Almacene una imagen procese y almacene una imagen
- Actualice a no privado cambie un asset a no privado
- Publique la colección mediante una solicitud cURL una sola vez
- Renderice el asset desde la API mediante una solicitud cURL una sola vez
Primero siga esta sección de la Guía de Servicio de Minteo de Coleccionables para crear un Cloudflare Worker
1. Obtenga una clave API secreta
Para utilizar el servicio backend, debe obtener una Secret API
Key para autenticar las solicitudes a su proyecto.
Primero, acceda a la configuración y seleccione las claves API desde el Sequence Builder Console
Desplácese hacia abajo y seleccione + Add Service Account
Luego cambie el acceso a write
y confirm
Finalmente, copie
la clave y guárdela en su wrangler.toml
como JWT_ACCESS_KEY
, ya que no podrá acceder a ella en el futuro desde el Sequence Builder Console.
2. Crear una colección desde una solicitud cURL
Como requisito previo para subir medios al servicio, primero debe crear una colección. Utilice la Secret API Key
y el projectID
obtenidos desde el Builder Console
Llamamos al servicio para obtener un collectionID
Luego, establecemos el collectionID
de la respuesta recibida en el wrangler.toml
como COLLECTION_ID
3. Crear un token usando TokenID
Si usa un worker de Cloudflare, asegúrese de agregar node_compat = true
a su wrangler.toml
para que el objeto window esté disponible para el paquete @0xsequence/metadata
Instale el paquete de metadata para usar SequenceCollections
con pnpm install @0xsequence/metadata
4. Crear un asset usando TokenID
En la solicitud, establezca el metadadaField
(assetType) en image
, completando los otros campos necesarios para obtener una respuesta de asset que se usará en el siguiente paso
5. Almacenar el asset de imagen
Con el asset.id
proporcionado del objeto jsonCreateAsset
anterior
Donde el uploadAssetRes.url
devuelto es la URL del archivo multimedia alojado en los servidores de Sequence
6. Actualizar token no privado
Ahora, hacemos que el token sea no privado estableciendo el booleano private
en false
7. Publicar colección desde una solicitud cURL
Finalmente, también como una solicitud única, publicamos la colección usando el projectID
y el collectionID
ejecutando el siguiente comando
Esto hará que la colección y todos los tokens con la propiedad private
establecida en false
sean accesibles públicamente, mientras que los demás permanecerán ocultos hasta que se cambie su estado
8. Renderizar asset desde la API públicamente
Puede probar su trabajo anterior llamando a esta solicitud cURL con las variables actualizadas, lo que descargará el archivo en su terminal local.
O puede copiar y pegar la URL en un navegador y ver la imagen
Si usó el mismo código, el <file_name>
será image.png
Y si estaba usando la colección para el baseURI
de un ERC721
o ERC1155
, escribiría en un smart contract setBaseMetadataURI
la siguiente URI
Y el smart contract agregará automáticamente el tokenID
al final
Pruébelo usted mismo
O en un navegador
Renderizar asset desde la API de forma privada
Alternativamente, puede decidir mantener sus assets almacenados como privados, pero aún así renderizar los datos pasando una clave secreta de API en el header
junto con los parámetros completos; para esta guía el metadata_field
está configurado como image
El código completo para esta guía se encuentra aquí