{"repo":"vultr/govultr","free":true,"listed":false,"github":"https://github.com/vultr/govultr","clone":"git clone https://github.com/vultr/govultr.git","description":"Vultr Go API client","language":"Go","stars":256,"topics":["go","golang","vultr","vultr-api","api"],"license":"MIT","category":"api-integrations-sdks","readme_excerpt":"GoVultr The official Vultr Go client - GoVultr allows you to interact with the Vultr V2 API. Installation Usage Vultr uses a personal access token (PAT) to interact/authenticate with the APIs. Generate an API Key from the API menu in the Vultr Customer Portal. To instantiate a GoVultr client, invoke NewClient() . Most operations require that you pass a PAT to an oauth2 library to create the http.Client , which configures the Authorization header with your PAT as the bearer api-key . If a PAT is not provided, public operations like listing plans or applications will still work. The client has three optional parameters: - BaseUrl: Change the Vultr default base URL - UserAgent: Change the Vultr default UserAgent - RateLimit: Set a delay between calls. Vultr limits the rate of back-to-back calls. Use this parameter to avoid rate-limit errors. Example Client Setup Passing nil to NewClient will work for routes that do not require authentication. Example Usage Create a VPS Pagination GoVultr v2 introduces pagination for all list calls. Each list call returns a meta struct containing the total amount of items in the list and next/previous links to navigate the paging. Pass a per page value to the list options struct to adjust the number of items returned per call. The default is 100 items per page and max is 500 items per page. This example demonstrates how to retrieve all of your instances, with one instance per page. Versioning This project follows SemVer for versioning. For the ve","default_branch":null,"files":null,"tree":[],"storefront":"/r/vultr","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/vultr/govultr/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}