> For the complete documentation index, see [llms.txt](https://docs.videsk.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.videsk.io/es-developers/vpaas/introduccion.md). # Introducción Antes de comenzar, debes saber que el diseño de nuestra API VPaaS está diseñado para simplificar el desarrollo de aplicaciones de videollamada. Por ello entregamos los siguientes mecanismos únicos en su clase: * Stateless: puedes usar tus propios IDs al crear salas, pudiendo buscar salas y volver a generar tokens usando tu propio ID. * Expirable: Indicando fecha de inicio (opcional) y término (opcional), automáticamente concederemos o denegaremos acceso a las salas basado en las fechas indicadas. *** ## Límites Por defecto, permitimos un acceso máximo de 3 horas por sala, el cual se puede sobreescribir hasta 72 horas con la key `exp` en los endpoints: [Rooms API](/es-developers/vpaas/rooms-api.md#post-vpaas-rooms) y [Rooms API](/es-developers/vpaas/rooms-api.md#patch-vpaas-rooms-roomid). La fecha de expiración es 3 horas después de la fecha de solicitud de creación de sala. Puedes reemplazar este comportamiento definiendo `exp` como fecha. Al mismo tiempo, `nbf` por defecto se define en la fecha de creación de la sala. #### Rate limit Actualmente, para todos los clientes, el límite de solicitudes por segundo es de 20. Esta restricción la podrás leer directamente desde nuestras cabeceras: * `Ratelimit-Limit`: indica req/s de tu cuenta, defecto: 20 * `Ratelimit-Remaining`: total de solicitudes disponibles en la siguiente ventana de 1 s * `Ratelimit-Reset`: indica la ventana de tiempo en que se restablecerá el límite, defecto: 1 * `Ratelimit-Policy`: Indica la política en formato 2020 [estándar propuesto](https://www.ietf.org/archive/id/draft-polli-ratelimit-headers-02.html). {% hint style="info" %} En caso de que tengas un aumento de solicitudes por segundo, puedes contactar con soporte o tu ejecutivo de ventas para ampliar este límite. {% endhint %} *** ## Seguridad Puedes limitar qué IPs pueden realizar la creación de salas a través de los endpoints disponibles[Rooms API](/es-developers/vpaas/rooms-api.md). Este formato pueden ser IPv4s, IPv6s o bien CIDRs, lo cual validaremos en cada solicitud. {% hint style="info" %} Recomendamos que, para ambientes de desarrollo, evites definir una lista blanca; de esta manera podrás testear localmente sin restricciones. {% endhint %} {% hint style="warning" %} En caso que evidencies alguna vulnerabilidad puedes contactarnos a , o bien podrás encontrar nuestros contactos en las cabeceras HTTP `X-Security-Report` y `X-Security-Site` en todos nuestros dominios y subdominios. {% endhint %} *** ## Casos de uso ### Salas on-demand Este caso de uso describe el flujo de crear una sala on-demand para acceso inmediato, lo que consigues usando nuestro endpoint [Rooms API](/es-developers/vpaas/rooms-api.md#post-vpaas-rooms). ```mermaid sequenceDiagram participant YB as Your Backend participant VV as Videsk VPaaS participant VU as Video User YB->>VV: 1. POST /vpaas/rooms VV->>YB: 2. accessToken
(opcional: guardar en DB) YB->>VU: 3. send accessToken ``` ### Salas agendadas Este caso describe cómo crear una sala para el futuro, donde podrás indicar opcionalmente la fecha de inicio y fin, asegurando que no se pueda ingresar antes de la fecha de inicio y que se pueda expulsar automáticamente después de la fecha indicada. Esto se consigue definiendo el cuerpo de la solicitud para el [Rooms API](/es-developers/vpaas/rooms-api.md#post-vpaas-rooms) ```json { "exp": "2042-08-14T18:00:00.000Z", // Fecha de término "bnf": "2042-08-14T16:50:00.000Z" // Fecha de inicio } ``` ```mermaid sequenceDiagram participant YB as Your Backend participant VV as Videsk VPaaS participant VU as Video User YB->>VV: 1. POST /vpaas/rooms VV->>YB: 2. accessToken
(opcional: guardar en DB) VU->>YB: 3. solicita unirse YB->>VV: 4. GET /vpaas/rooms/{roomId} VV->>YB: 5. accessToken
(opcional: guardar en DB) YB->>VU: 6. send accessToken ``` ### Actualizar fecha de inicio Este caso describe la situación de crear una sala y posteriormente la necesidad de actualizar la fecha de inicio a través del endpoint [Rooms API](/es-developers/vpaas/rooms-api.md#patch-vpaas-rooms-roomid). ```json { "nbf": "2042-08-17T09:25:00.000Z" } ``` ```mermaid sequenceDiagram participant YB as Your Backend participant VV as Videsk VPaaS participant VU as Video User YB->>VV: 1. POST /vpaas/rooms VV->>YB: 2. accessToken
(opcional: guardar en DB) VU->>YB: 3. solicita cambiar fecha YB->>VV: 4. PATCH /vpaas/rooms/{roomId}
{nbf: ...} VV->>YB: 5. accessToken
(opcional: guardar en DB) YB->>VU: 6. fecha cambiada ``` --- # 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: ``` GET https://docs.videsk.io/es-developers/vpaas/introduccion.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.