Anuncio del SDK Vonage Node v3.0.0

Así es, v3 del SDK de nodos. Se ha lanzado una función largamente solicitada, además de dividir el SDK en componentes más pequeños, lo que ayudará al equipo a lanzar nuevas funciones con mayor rapidez.

Cambios de última hora

Promesas

Se han eliminado todas las retrollamadas de función. En el futuro, deberá utilizar async/await o .then/.catch. Esto hará que tu código sea más limpio al evitar el infierno de las retrollamadas. Por ejemplo:

const Vonage = require('@vonage/server-sdk')

const vonage = new Vonage({
    apiKey: VONAGE_API_KEY,
    apiSecret: VONAGE_API_SECRET,
})

const from = VONAGE_BRAND_NAME;
const to = TO_NUMBER;
const text = 'A text message sent using the Vonage SMS API'

vonage.message.sendSms(from, to, text, (err, responseData) => {
    if (err) {
        console.log(err);
        return;
    }

    if(responseData.messages[0]['status'] === "0") {
        console.log("Message sent successfully.");
        return;
    } 
    
    console.log(`Message failed with error: ${responseData.messages[0]['error-text']}`);
})

Ahora se puede escribir como:

const { Vonage } = require('@vonage/server-sdk')

const vonage = new Vonage({
    apiKey: VONAGE_API_KEY,
    apiSecret: VONAGE_API_SECRET,
})

const from = VONAGE_BRAND_NAME;
const to = TO_NUMBER;
const text = 'A text message sent using the Vonage SMS API';

const sendSMS = async () {
    try {
        const response = await vonage.sms.send({to, from, text});
        console.log(response);
    } catch (err) {
        console.log('There was an error sending the messages.'); 
        console.error(err);
    }
};

Actualización de parámetros

Las funciones también se han actualizado para utilizar objetos parámetro en lugar de argumentos de función. Esto ayudará a que las funciones con muchos parámetros opcionales sean más manejables. Hemos publicado un documento de migración para cada paquete que describirá qué funciones se han actualizado con más detalle.

Guía de migración

Aquí encontrará las guías de migración de cada paquete:

• Account

• Applications

• Mensajes

• Perspectivas numéricas

• Numbers

• Precios

• SMS

• Verify

• Voice

Paquetes más pequeños y tipografía

La versión 3 utiliza Typescript para ayudar a completar el código en tu IDE preferido. Pero una mejora aún mayor es el uso de monorepos. Un monorepo divide la base de código en paquetes más pequeños, manteniendo intacto el árbol de dependencias. Ahora puede utilizar paquetes específicos en su aplicación en lugar de incluir todo el conjunto de productos. Hicimos este cambio estratégicamente para permitirnos lanzar características beta y correcciones sin retrasar la rama de desarrollo principal. Un ejemplo de esto es el nuevo paquete Video API (que en el pasado formaba parte del SDK de OpenTok):

import { Auth } from '@vonage/auth';
import { Video } from '@vonage/video';

const credentials = new Auth({
    apiKey: VONAGE_API_KEY,
    apiSecret: VONAGE_API_SECRET,
});

const video = new Video(credentials);

const getVideoSession = async () => {
    try {
        const session = await video.createSession({ mediaMode: 'routed' });
        console.log('Session created', session);
        return session;
    } catch (error) {
        console.log('Failed to create session');
        console.error(error);
        throw error;
    }
}

Ahora puede utilizar un paquete SDK beta y conservar los paquetes estables.

Ayuda

En nuestro documento continuaremos dando soporte a la versión 2 durante otros seis meses, hasta mayo de 2023. No añadiremos nuevas funciones, solo correcciones.

Para obtener información más detallada, visite la documentación del SDK o consulte los fragmentos de código. Puedes comunicarte con nosotros en Slack para desarrolladores de Vonage y mantente informado siguiendo VonageDev en Twitter.