Anunciamos Vonage Ruby SDK Versión 7.3.0

El SDK Ruby de Vonage recientemente publicó una nueva versión, v7.3.0. Esta nueva versión introduce una función de autopaginación para los métodos de lista de API, lo que agiliza la recopilación de datos de las API de Vonage.

Exploremos el razonamiento que hay detrás y cómo funciona.

¿Por qué introducir la paginación automática?

¿Por qué deberías pensar en la paginación cuando trabajas con las API de Vonage y cómo la paginación automática mejora tu experiencia?

Podemos entenderlo mejor si nos fijamos en un ejemplo del mundo real.

Voice API de Vonage tiene la capacidad de obtener detalles de todas tus llamadas. Cuando hacemos esta GET a la API sin ningún parámetro, devuelve por defecto sólo las primeras diez.

¿Qué ocurre si tiene más de diez llamadas? Deberá seguir realizando solicitudes posteriores a la API por cada página adicional de registros. Eso significa llevar un registro de la página actual, el número de páginas restantes y el número de registros por página. Eso quizá sea más carga cognitiva de la esperada cuando lo único que quieres es una lista de tus llamadas.

Afortunadamente, este trabajo ahora se abstrae de tu responsabilidad con la v7.3.0 del SDK de Ruby.

Como describe el equipo del SDK de Vonage en una entrada de blogcreemos firmemente que nuestros SDK deben facilitarte la vida como desarrollador y permitirte hacer tu trabajo de la manera más sencilla posible. La paginación automática en el SDK de Ruby es otro paso hacia ese gran objetivo.

¿Cómo funciona?

A medida que introducimos nuevas funciones en el SDK de Ruby, es crucial que afecten lo menos posible a los flujos de trabajo de todos los que lo utilizan habitualmente para realizar su trabajo. Como tal, la autopaginación requiere que hagas muy poco para aprovechar sus mejoras.

Solicitar todos sus registros de llamadas telefónicas ahora se puede lograr con la misma llamada de método que ha estado utilizando en el SDK:

client = Vonage::Client.new
client.applications.list

Sin embargo, ahora el SDK avanzará automáticamente por todas las páginas de registros y las añadirá a la colección de llamadas que se le devuelven. Antes, esta llamada al método solo devolvía el número predeterminado de registros para la API (en este caso, 10), y tendrías que realizar más solicitudes a la API para recopilar el resto.

Hay situaciones en las que no querrá devolver todos los registros. Es posible desactivar la autopaginación introduciendo un argumento adicional en la llamada al método auto_advance: false. Por ejemplo, si desea devolver sólo las cinco primeras llamadas, el método tendría el siguiente aspecto:

client = Vonage::Client.new
client.applications.list(page_size: 5, auto_advance: false)

Sólo tiene que añadir el argumento auto_advance en su código cuando no desee específicamente el comportamiento por defecto. Para la mayoría de las APIs, el comportamiento por defecto es el auto-avance.

¿Y ahora qué?

Tenemos planes muy interesantes para el SDK de Ruby. Seguimos ampliando las funciones del SDK para que se ajuste mejor a nuestro objetivo de ser un recurso que no sólo realice solicitudes HTTP por ti, sino que también te facilite y agilice tus tareas.

La participación de la comunidad es siempre bienvenida. No dude en unirse a nosotros en GitHub y en Slack de la comunidad de Vonage.