Ankündigung des Vonage Node SDK v3.0.0

Das ist richtig, v3 des Node-SDKs ist nun vollständig versprochen. Eine lange geforderte Funktion wurde veröffentlicht, zusammen mit der Aufteilung des SDK in kleinere Komponenten, die dem Team helfen werden, neue Funktionen schneller zu veröffentlichen.

Wechselnde Änderungen

Versprechen

Alle Funktionsrückrufe wurden entfernt. In Zukunft müssen Sie async/await oder verwenden. .then/.catch. Dies sollte Ihren Code sauberer machen, indem Sie die Callback-Hölle vermeiden. Zum Beispiel:

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']}`);
})

Sie kann nun wie folgt geschrieben werden:

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);
    }
};

Parameter-Aktualisierungen

Die Funktionen wurden ebenfalls aktualisiert und verwenden nun Parameterobjekte anstelle von Funktionsargumenten. Dies wird dazu beitragen, dass Funktionen mit vielen optionalen Parametern besser verwaltet werden können. Wir haben für jedes Paket ein Migrationsdokument veröffentlicht, in dem die aktualisierten Funktionen ausführlicher beschrieben werden.

Leitfaden zur Migration

Migrationsleitfäden für jedes Paket finden Sie hier:

• Konten

• Applications

• Nachrichten

• Nummer Einblicke

• Numbers

• Preisgestaltung

• SMS

• Verify

• Voice

Kleinere Pakete und Typografie

Version 3 verwendet Typescript zur Unterstützung der Code-Vervollständigung in Ihrer bevorzugten IDE. Aber eine noch größere Verbesserung ist die Verwendung von monorepos. Ein Monorepo bricht die Codebasis in kleinere Pakete auf, wobei der Abhängigkeitsbaum intakt bleibt. Jetzt können Sie bestimmte Pakete in Ihrer Anwendung verwenden, anstatt die gesamte Produktsuite einzubeziehen. Wir haben diese Änderung strategisch vorgenommen, um Beta-Funktionen und Fehlerbehebungen veröffentlichen zu können, ohne den Hauptentwicklungszweig aufzuhalten. Ein Beispiel dafür ist das neue Video API-Paket (das in der Vergangenheit Teil des OpenTok SDK):

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;
    }
}

Jetzt können Sie ein Beta-SDK-Paket verwenden und die stabilen Pakete behalten.

Unterstützung

Nach unserem Support Dokument werden wir die Version 2 noch weitere sechs Monate unterstützen, also bis etwa Mai 2023. Wir werden keine neuen Funktionen hinzufügen, sondern nur Korrekturen vornehmen.

Ausführlichere Informationen finden Sie in der SDK-Dokumentation oder in den Codeschnipseln. Sie können uns über den Vonage Entwickler-Slack erreichen und auf dem Laufenden bleiben, indem Sie VonageDev auf Twitter folgen.