> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-es/escenas-sdk7/redes/network-connections.md). # Conexiones de red Tu escena puede aprovechar servicios externos que expongan APIs; puedes usar esto para obtener datos de precios actualizados, datos meteorológicos o cualquier otro tipo de información expuesta por una API. También puedes configurar tu propio servidor externo para ayudar a tu escena y servir para sincronizar datos entre tus jugadores. Esto puede hacerse con un servidor que exponga una REST API, o con un servidor que use WebSockets. ## Llamar a una API REST El código de tu escena puede enviar llamadas a una REST API para obtener datos. Dado que el servidor puede tardar en enviar su respuesta, debes ejecutar este comando como una [función asíncrona](/creator/content-creator-es/escenas-sdk7/patrones-de-programacion/async-functions.md), usando `executeTask()`. ```ts executeTask(async () => { try { let response = await fetch(callUrl) let json = await response.json() console.log(json) } catch { console.log('no se pudo acceder a la URL') } }) ``` El comando fetch también puede incluir un segundo argumento opcional que agrupa headers, el método HTTP y el cuerpo HTTP en un solo objeto. * **url**: Dirección a la que enviar la solicitud * **init**: Un `RequestInit` objeto que puede contener: * **method** : método HTTP a usar (GET, POST, DELETE, etc.) * **body**: Contenido del cuerpo de la solicitud. Debe enviarse como un objeto JSON serializado en una cadena. * **headers**: headers adicionales a incluir en la solicitud. * **redirect**: estrategia de redirección ('follow' | 'error' | 'manual') * **timeout**: Cuánto tiempo esperar una respuesta antes de que falle la solicitud. Por defecto, 30000 milisegundos (30 segundos). ```ts executeTask(async () => { try { let response = await fetch(callUrl, { headers: { 'Content-Type': 'application/json' }, method: 'POST', body: JSON.stringify(myBody), }) let json = await response.json() console.log(json) } catch { console.log('no se pudo acceder a la URL') } }) ``` El comando fetch devuelve un `response` objeto con los siguientes datos: * `headers`: Un `ReadOnlyHeaders` objeto. Llama al `get()` método para obtener un header específico, o al `has()` método para comprobar si un header está presente. * `ok`: Booleano * `redirected`: Booleano * `status`: Número del código de estado * `statusText`: Texto del código de estado * `type`: Tendrá uno de los siguientes valores: *basic*, *cors*, *default*, *error*, *opaque*, *opaqueredirect* * `url`: URL que se envió * `json()`: Obtener el cuerpo en formato JSON. * `text()`: Obtener el cuerpo como texto. {% hint style="warning" %} **📔 Nota**: `json()` y `text()` son mutuamente excluyentes. Si obtienes el cuerpo de la respuesta en uno de los dos formatos, ya no podrás obtener el otro a partir de la `response` objeto. {% endhint %} {% hint style="warning" %} **📔 Nota**: Cada escena de Decentraland solo puede realizar un `fetch` comando a la vez. Esto no afecta a cómo debe estructurarse el código de la escena, ya que las solicitudes se ponen en cola internamente. Si tu escena requiere enviar múltiples solicitudes a diferentes endpoints, ten en cuenta que cada solicitud solo se envía cuando la anterior ha recibido respuesta. {% endhint %} ## Solicitudes firmadas Puedes emplear una medida de seguridad adicional para certificar que una solicitud proviene de una sesión de jugador dentro de Decentraland. Puedes enviar tus solicitudes con una firma adicional, firmada usando una clave efímera que la sesión de Decentraland genera para cada jugador según la dirección del jugador. Luego, el servidor que recibe la solicitud puede verificar que el mensaje firmado efectivamente coincida con una dirección que esté actualmente activa en el mundo. Este tipo de medidas de seguridad son especialmente valiosas cuando puede haber un incentivo para que un jugador abuse del sistema, para acumular tokens o puntos en un juego. Para enviar una solicitud firmada, solo necesitas usar la `signedFetch()` función, exactamente de la misma manera en que usarías la `fetch()` función. ```ts import { signedFetch } from '~system/SignedFetch' executeTask(async () => { try { let response = await signedFetch({ url: callUrl, init: { headers: { 'Content-Type': 'application/json' }, method: 'POST', body: JSON.stringify(myBody), }, }) if (!response.ok) { throw new Error('Respuesta no válida') } let json = JSON.parse(response.body) console.log('Respuesta recibida: ', json) } catch { console.log('no se pudo acceder a la URL') } }) ``` La solicitud incluye una serie adicional de headers, que contienen un mensaje firmado y un conjunto de metadatos para interpretarlo. El mensaje firmado consiste en todo el contenido de la solicitud cifrado usando la clave efímera del jugador. El `signedFetch()` se diferencia de la `fetch()` función en que la respuesta es una promesa de un mensaje HTTP completo, expresado como un `FlatFetchResponse` objeto. Esto incluye las siguientes propiedades: * `body` * `headers` * `ok` * `status` * `statusText` El **body** siempre es una cadena, que puedes analizar como en el ejemplo anterior. ### Validar una solicitud firmada Para hacer uso de las solicitudes firmadas, el servidor que las recibe debe validar que las firmas coincidan con el resto de la solicitud y que la marca de tiempo codificada dentro del mensaje firmado sea actual. Puedes encontrar un ejemplo sencillo de un servidor que realiza esta tarea en la siguiente escena de ejemplo: [Validar la autenticidad del jugador](https://github.com/decentraland-scenes/validate-player-authenticity) ## Tiempo de espera de la solicitud Si una solicitud HTTP tarda demasiado en recibir respuesta, falla para que se puedan enviar otras solicitudes. Para `fetch()`, el umbral de tiempo de espera predeterminado es de 30 segundos, pero puedes asignar un valor diferente en cada solicitud configurando la `timeout` propiedad. El valor de `timeout` se expresa en milisegundos. ```ts fetch('https://some-url.com', { timeout: 1000 }) ``` ## Usar WebSockets También puedes enviar y obtener datos desde un servidor WebSocket, siempre que este servidor use una conexión segura con *wss*. ```ts var socket = new WebSocket('url') socket.onmessage = function (event) { console.log('Mensaje de WebSocket recibido:', event) } ``` La sintaxis para usar WebSockets no es diferente de la implementada de forma nativa por JavaScript. Consulta la documentación de [Mozilla Web API](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket) para obtener detalles sobre cómo recibir y enviar mensajes a través de WebSockets. {% hint style="info" %} **💡 Consejo**: Una biblioteca que simplifica el uso de conexiones websocket y ha demostrado funcionar muy bien con Decentraland es [Colyseus](https://colyseus.io/). Varias otras bibliotecas websocket no son compatibles con el SDK de Decentraland. Construye una capa de abstracción sobre las conexiones websocket que hace que reaccionar a los cambios y almacenar de forma remota en el servidor un estado de juego coherente sea muy fácil. Puedes verlo en acción en estos ejemplos: * [Cube Jumper](https://github.com/decentraland-scenes/cube-jumper-colyesus-sdk7) * [Space Traitor](https://github.com/decentraland-scenes/Space-Traitor) * [AI NPC](https://github.com/decentraland-scenes/inworld-ai-sdk7) {% endhint %} ## Depurar solicitudes de red Puedes depurar solicitudes de red abriendo el Debug Panel. Para abrir el Debug Panel, puedes hacer clic en el ![](/files/f5cc7d26a9668244475b8d117c58164598bc35a3) icono en la esquina superior derecha. Luego selecciona la **Web Requests** pestaña y haz clic en **Abrir Chrome Devtools**. Esto abrirá una nueva ventana de Chrome con la pestaña Network abierta. Consulta [Depurar en Preview](/creator/content-creator-es/escenas-sdk7/depuracion/debug-in-preview.md#web-requests) para ver más detalles. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.decentraland.org/creator/content-creator-es/escenas-sdk7/redes/network-connections.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.