2 posts tagged with "Go"

The DynamicPDF Client libraries make using the DynamicPDF Cloud API a breeze. We have Node.js, .NET, Java, PHP, and Go client libraries. But sometimes, you might want to call the DynamicPDF Cloud API directly as a REST call to your project without using any coding. In this blog post, we use the .bubble.io API to call the dlex-layout endpoint directly as a REST call with no coding.

bubble.io​

The bubble.io allows developer to create interactive websites and APIs using no coding. To use bubble.io register for free account.

Also, if you do not have a DynamicPDF Cloud API account, register for a free account here. Both offer free accounts and allow you to upgrade as needed seamlessly. Refer to the numerous examples and documentation (Getting Started).

Refer to the bubble.io documentation for complete documentation on creating and using an API; here, we illustrate using the Add another call button to add a call to your API.

Creating a New Plugin​

The first step in creating a new plugin is to navigate to the Plugins page and create a new one (figure 1).

1. Click on the Plugins tab to be taken to the Plugins screen.
2. Click the Create a plugin button to create a new plugin.

Figure 1. Creating a new plugin.

3. Name the new plugin DynamicPDF Endpoint Example then click Create plugin.

Figure 2. Naming the plugin.

Creating the Plugin​

After initially creating a new plugin it takes you to the details screen for creating the plugin (figure 3).

1. Add an image as your logo. I chose the DynamicPDF CloudAPI logo.
2. Add an endpoint description to the Description field.
3. Select a category for the plugin (I chose Technical).

Figure 3. Describing the plugin.

Plugin API Calls​

After describing the plugin you create the plugin details by completing the Plugin API Calls tab (figure 4).

1. Select the API calls tab to be taken to the Plugin API Calls screen.
2. Assign a name to the API Name.
3. Select Add another call to expand and show the fields needed to define the API call.

Figure 4. Creating the Call.

After selecting Add another call, the screen adds more fields to enter the call's details (figure 5).

1. Assign a name for the call (here dlex-layout-call). Select Data from the Use as dropdown and select File from the Data type dropdown.
2. Select POST and add the URL to the REST call (https:://api.dynamicpdf.com/v1.0/dlex-layout) .
3. Click Add header to add a new header.
4. Assign Authorization as the Key and write Bearer for the value.

Now you must get the authorization key from your DynamicPDF account.

5. Go to your DynamicPDF CloudAPI account and select Apps and API Keys.
6. Copy your API key by clicking [copy].
7. Paste the value to the field after Bearer, the complete value is Bearer *your api key value*.

Figure 5. Add your API key as a header parameter.

After creating a header and adding your API key, you create a form field for the path to your DLEX file.

1. Click Add parameter to create a new parameter.
2. Select Form-data as the Body type.
3. Assign DlexPath as the Key.
4. Navigate to your DynamicPDF account and select Manage Resources.
5. Navigate to the dlex-layout folder in the samples folder, highlight the file path, right-click, and select Copy File Path to copy the file path to your clipboard.
6. Paste the value for the parameter in the Value field.

Figure 6. Adding the DlexPath to the call.

After adding the API key and the DlexPath, add the path to the layout data (figure 7).

1. Click Add parameter to add another parameter.
2. Assign LayoutData as the Key.
3. Check the Send file checkbox.
4. Click Upload to open a file dialog.
5. Select the file to upload the layout data (SimpleReportWithCoverPage.json).

Figure 7. Adding the LayoutData to the call.

1. Click Reinitialize call to reinitialize it.
2. Click to preview the call.

Figure 8. Initializing and previewing the API call.

After clicking the preview link, your newly created API calls the dlex-layout endpoint and opens the created PDF in a new browser tab (figure 9).

Figure 9. Previewing the dlex-layout API call's resultant PDF.

Conclusion​

Upon clicking the Plugins tab, you will see your newly created API listed (figure 10). You can edit the API and when satisfied, you can register it so that others can use the API or you can use it privately in your own applications. Refer to the bubble.io documentation for more information on using your API.

Figure 10. Your newly created plugin.

Although using the DynamicPDF CloudAPI with one of it's client libraries is the most robust way to use the CloudAPI, it is also easily integrated into one of the available codeless development tools available on the web.

The Go programming language client library is now available. Download the client library's source from GitHub. Also, check out the new examples on GitHub illustrating how to use this library with the Cloud API.

• Go Client Package
• Go Client Library Source
• Go Client Library Examples

Client libraries make using the DynamicPDF Cloud API a breeze. We already have client libraries written in Node.js, .NET, Java, and PHP. And now we have a fifth client library, Go. Get started using Go today!