vonage java sdk

Vonage Server SDK untuk Java

Java SDK ini memungkinkan Anda untuk menggunakan Vonage API dalam aplikasi berbasis JVM apa pun. Anda harus membuat akun Vonage.

• API yang didukung
• SDK lainnya
• Instalasi
• Penggunaan
• Konfigurasi
• FAQ
• Menyumbang!

API yang didukung

• Akun
• Aplikasi
• Percakapan
• Konversi
• Pesan
• Wawasan angka
• Manajemen angka
• Verifikasi nomor
• Menyusun
• SIM SWAP
• SMS
• Subaccount
• Memeriksa
• Video
• Suara

SDK lainnya

Kami juga menyediakan SDK server dalam bahasa lain:

• Kotlin
• .BERSIH
• Php
• Python
• Rubi
• NodeJS

Kami juga menawarkan SDK sisi klien untuk iOS, Android dan JavaScript. Lihat semua SDK dan integrasi kami di Portal Pengembang Vonage.

Instalasi

Rilis diterbitkan ke Maven Central. Instruksi untuk sistem build Anda dapat ditemukan di bagian cuplikan. Kami sangat menyarankan Anda menggunakan alat yang mendukung manajemen ketergantungan, seperti Maven, Gradle atau Ivy.

Catatan rilis untuk setiap versi dapat ditemukan di Changelog.

Bangun sendiri

Atau Anda dapat mengkloning repo dan membangun file jar sendiri:

git clone [email protected]:vonage/vonage-java-sdk.git
mvn install -P uberjar

Profil uberjar akan membuat file jar dengan semua dependensi yang diperlukan untuk menjalankan SDK yang disertakan, yang dapat ditemukan di direktori target . Tujuan install akan membuat SDK dan ketergantungannya tersedia di repositori Maven lokal Anda (biasanya terletak di bawah direktori ~/.m2 Anda), yang kemudian dapat digunakan dari proyek lain secara lokal di mesin Anda. Untuk menggunakan ini dalam proyek Gradle, Anda perlu memasukkan koordinat ketergantungan dan menambahkan mavenLocal() ke blok repositories dalam file build.gradle Anda.

Penggunaan

• Untuk bantuan memahami API kami, lihat portal pengembang kami yang luar biasa.
• Periksa Javadoc untuk dokumentasi referensi lengkap.
• Ada juga banyak sampel kode yang berguna di repositori vonage/vonage-java-code-snippets kami.
• Untuk instruksi penggunaan API video, lihat panduan di portal pengembang kami.

Konfigurasi

Instantiasi khas

Untuk konfigurasi default, Anda hanya perlu menentukan kredensial akun vonage Anda menggunakan kunci API dan rahasia, kunci pribadi dan ID aplikasi atau keduanya. Untuk kompatibilitas maksimum dengan semua API, disarankan agar Anda menentukan kedua metode otentikasi, seperti itu:

 VonageClient client = VonageClient . builder ()
        . applicationId ( APPLICATION_ID )
        . privateKeyPath ( PRIVATE_KEY_PATH )
        . apiKey ( API_KEY )
        . apiSecret ( API_SECRET )
        . build ();

Kustomisasi URI Pangkalan

Secara default, klien akan menggunakan https://api.nexmo.com, https://rest.nexmo.com, https://api-eu.vonage.com dan https://video.api.vonage.com sebagai pangkalan uris untuk berbagai titik akhir. Untuk menyesuaikan ini, Anda dapat membuat instantiate VonageClient dengan objek HttpConfig .

HttpConfig.Builder telah dibuat untuk membantu membangun objek ini. Penggunaan adalah sebagai berikut:

 HttpConfig httpConfig = HttpConfig . builder ()
        . apiBaseUri ( "https://api.example.com" )
        . restBaseUri ( "https://rest.example.com" )
        . apiEuBaseUri ( "https://api-eu.example.com" )
        . videoBaseUri ( "https://video.example.com" )
        . build ();

VonageClient client = VonageClient . builder ()
        . apiKey ( API_KEY ). apiSecret ( API_SECRET )
        . httpConfig ( httpConfig )
        . build ();

Jika Anda tidak menentukan properti, itu akan mengambil nilai default apa pun. Anda juga dapat mengatur ketiganya dengan satu metode:

 HttpConfig httpConfig = HttpConfig . builder (). baseUri ( "http://example.com" ). build ();

VonageClient client = VonageClient . builder ()
        . apiKey ( API_KEY ). apiSecret ( API_SECRET )
        . httpConfig ( httpConfig )
        . build ();

Batas waktu khusus

Secara default, SDK memiliki batas waktu 1 menit untuk permintaan. Anda dapat mengubah ini menjadi lebih panjang atau lebih pendek menggunakan HttpConfig . Contoh berikut menetapkan ini menjadi 12 detik:

 VonageClient client = VonageClient . builder ()
        . applicationId ( APPLICATION_ID )
        . privateKeyPath ( PRIVATE_KEY_PATH )
        . httpConfig ( HttpConfig . builder (). timeoutMillis ( 12_000 ). build ())
        . build ();

Pertanyaan yang sering diajukan

T: Apa yang terjadi dengan com.vonage:client ?

A: Untuk menghindari kebingungan dengan berbagai SDK sisi klien kami, SDK sisi server ini telah dipindahkan dari com.vonage:client ke com.vonage:server-sdk . Artifactid lama ( com.vonage:client ) tidak akan menerima pembaruan lebih lanjut. Semua pengguna harus bermigrasi ke artefactid baru. Harap dicatat bahwa SDK secara fungsional sama, itu hanya perubahan namespace di Maven Central.

T: Apa kebijakan Anda tentang keamanan utas?

A: Arsitektur SDK saat ini berarti bahwa hanya satu utas yang harus menggunakan klien sekaligus. Jika Anda ingin menggunakan SDK di lingkungan multithreaded, buat instance terpisah dari VonageClient untuk setiap utas.

T: Apakah SDK ini mendukung pemrosesan permintaan / respons asinkron?

A: Saat ini tidak, tetapi ada di peta jalan.

T: Bagaimana cara saya bermigrasi dari tokbox ke vonage?

A: Lihat Panduan Migrasi Opentok.

Menyumbang!

Kami ❤️ Kontribusi ke perpustakaan ini!

Adalah ide yang baik untuk berbicara dengan kami terlebih dahulu jika Anda berencana untuk menambahkan fungsionalitas baru. Jika tidak, laporan bug, perbaikan bug dan umpan balik di perpustakaan selalu dihargai.

Kontak