This is the community-supported Golang library for Vonage. It has support for most of our APIs, but is still under active development. Issues, pull requests and other input is very welcome. The package documentation is available on pkg.go.
If you don't already know Vonage: We make telephony APIs. If you need to make a call, check a phone number, or send an SMS then you are in the right place! If you don't have one yet, you can sign up for a Vonage account and get some free credit to get you started.
Find current and past releases on the releases page.
Import the package and use it in your own project
import ("github.com/vonage/vonage-go-sdk")
Usage examples are in the docs/ folder - also rendered via GitHub pages: https://vonage.github.io/vonage-go-sdk/
Current state of API support in this library:
| API | API Release Status | Supported? |
|---|---|---|
| Account API | General Availability | ❌ |
| Alerts API | General Availability | ❌ |
| Application API | General Availability | ✅ |
| Audit API | Beta | ❌ |
| Conversation API | Beta | ❌ |
| Dispatch API | Beta | ❌ |
| External Accounts API | Beta | ❌ |
| Media API | Beta | ❌ |
| Messages API | Beta | ❌ |
| Number Insight API | General Availability | ✅ |
| Number Management API | General Availability | ✅ |
| Pricing API | General Availability | ❌ |
| Redact API | Developer Preview | ❌ |
| Reports API | Beta | ❌ |
| SMS API | General Availability | ✅ |
| Verify API | General Availability | ✅ |
| Voice API | General Availability | ✅ |
Yes please! This library is open source, community-driven, and benefits greatly from the input of its users.
Please make all your changes on a branch, and open a pull request, these are welcome and will be reviewed with delight! If it's a big change, it is recommended to open an issue for discussion before you start.
All changes require tests to go with them.
Refer to this excellent blog post for instructions on how to use a local clone of this repository as the import in your own project. This is really useful when you are using a version of the library other than the latest stable release - for example if you are working on a change, or testing an open pull request.
We love to hear from you so if you have questions, comments or find a bug in the project, let us know! You can either:
- Open an issue on this repository
- Tweet at us! We're @VonageDev on Twitter
- Or join the Vonage Community Slack
- Check out the Developer Documentation at https://developer.nexmo.com - you'll find the API references for all the APIs there as well
- The documentation for the library: https://godoc.org/github.com/vonage/vonage-go-sdk
This library is released under the Apache 2.0 License