https://d226lax1qjow5r.cloudfront.net/blog/blogposts/announcing-the-vonage-apis-postman-collection/Blog_Postman_1200x600.png

Ankündigung der Vonage APIs Postman Collection

Zuletzt aktualisiert am May 11, 2021

Lesedauer: 2 Minuten

Bei Vonage veröffentlichen wir OpenAPI-Spezifikationen für alle unsere APIs. Diese Spezifikationen ermöglichen es unserer Entwicklergemeinschaft, die APIs von Vonage effizient zu erforschen, zu bewerten und zu integrieren.

Als Lorna in ihrem Artikel über Bewertung von APIs mit OpenAPIerwähnt, ist das Herunterladen einer OpenAPI-Spezifikation herunterladen und sie in Postman ist eine gute Möglichkeit, sich mit neuen APIs vertraut zu machen.

Ich könnte nicht mehr zustimmen! Falls Sie noch nicht vertraut sind mit Postmannoch nicht kennen, sollten Sie Postman ausprobieren, denn es ist eine freundliche grafische Oberfläche für einen leistungsstarken, plattformübergreifenden HTTP-Client.

Wir freuen uns, Ihnen mitteilen zu können, dass die Erkundung der Vonage APIs jetzt noch schneller und einfacher geworden ist! Wir haben eine Schaltfläche "Run in Postman" auf der Postman-Seite auf unserem EntwicklerportalDamit sind Sie nur noch ein paar Klicks von Ihrer ersten Anfrage entfernt.

Es ist auch auf dem Postman-Hauptnetz zu finden, wenn Sie es lieber dort durchsuchen möchten.

Sobald Sie auf die Schaltfläche In Postman ausführen klicken, werden Sie zur Postman-Instanz Ihrer Wahl weitergeleitet, und alle Vonage-API-Aufrufe warten auf Sie, gut organisiert in einer Sammlung.

Vonage APIs Postman collection imported view

Das Tolle an der Verwendung einer Postman Collection ist, dass wir die Anfragen für Sie vorbereiten können, so dass der Arbeitsaufwand für die API-Aufrufe minimal ist.

Sie hat auch einige nette Funktionen, wie die Möglichkeit, Umgebungsvariablen zu konfigurieren. Diese Sammlung wird mit einer Vonage-Umgebung die Folgendes auflistet API_KEY, API_SECRETund JWTsind die am häufigsten verwendeten Parameter, aber Sie können nach Belieben weitere hinzufügen. Sie finden die Umgebungen, indem Sie auf das Zahnradsymbol in der oberen rechten Ecke klicken.

Vonage environment variables in Postman Collection

Um Ihre Anmeldedaten hinzuzufügen, aktualisieren Sie die aktuellen Werte von API_KEY und API_SECRET mit dem API-Schlüssel und dem Geheimnis, die Sie in Ihrem Vonage-Dashboard (JWT muss im Moment nicht eingerichtet werden).

Verwendung der Vonage APIs Postman Collection

Als Nächstes wollen wir uns die Vonage APIs Postman Collection genauer ansehen, um die Numbers API.

Erweitern Sie den Sammlungsordner und suchen Sie den Ordner Numbers Ordner darin.

Numbers requests in Vonage APIs Postman collection

Mit der Numbers API von Vonage können Sie Ihren virtuellen Rufnummernbestand programmatisch verwalten. Um mehr über die verfügbaren Operationen zu erfahren, lesen Sie bitte die Numbers API-Referenz.

Für dieses Beispiel probieren wir die Funktion List numbers you own Eintrag.

Ihr api_key und api_secret werden dynamisch aus der Vonage-Umgebung übernommen. Vergewissern Sie sich also, dass Sie diese Werte in der Umgebung eingestellt haben, und klicken Sie dann auf Senden.

Numbers API List numbers you own response body

Et voilà! Sie haben erfolgreich Ihre erste Vonage API-Anfrage mit unserer Postman-Kollektion gestellt!

Probieren Sie es aus, haben Sie Spaß, und lassen Sie uns wissen, was Sie denken!

Wie geht es weiter?

Teilen Sie:

https://a.storyblok.com/f/270183/372x373/36054b72d0/julia-biro.png
Julia BiroAdvokat für Entwickler

Julia hat es sich zur Aufgabe gemacht, andere Entwickler durch die Erstellung von Tutorials, Anleitungen und praktischen Ressourcen zu unterstützen. Mit ihrem Hintergrund in den Bereichen Öffentlichkeitsarbeit und Bildung möchte sie Technologien zugänglicher machen und die Erfahrung von Entwicklern insgesamt verbessern. Man kann sie oft bei lokalen Veranstaltungen antreffen.