Image to Image in Golang

This page describes how to use the Pdfcrowd online API to convert between images formats in Golang. The API is user-friendly and can be integrated into your application with just a few lines of code.

Installation

You can install the client library from Github

go get github.com/pdfcrowd/pdfcrowd-go

Check out other installation options.

Quick Start

Here are Golang examples for quickly getting started with the API. See more examples.

package main

import (
    "os"
    "fmt"
    "github.com/pdfcrowd/pdfcrowd-go"
)

func main() {
    // create the API client instance
    client := pdfcrowd.NewImageToImageClient("your_username", "your_apikey")

    // configure the conversion
    client.SetOutputFormat("jpg")

    // run the conversion and write the result to a file
    err := client.ConvertFileToFile("/path/to/logo.png", "logo.jpg")

    // check for the conversion error
    handleError(err)
}

func handleError(err error) {
    if err != nil {
        why, ok := err.(pdfcrowd.Error)
        if ok {
            os.Stderr.WriteString(fmt.Sprintf("Pdfcrowd Error: %s\n", why))
        } else {
            os.Stderr.WriteString(fmt.Sprintf("Generic Error: %s\n", err))
        }

        panic(err.Error())
    }
}

package main

import (
    "os"
    "fmt"
    "github.com/pdfcrowd/pdfcrowd-go"
)

func main() {
    // create the API client instance
    client := pdfcrowd.NewImageToImageClient("your_username", "your_apikey")

    // configure the conversion
    client.SetOutputFormat("jpg")

    // run the conversion and write the result to a file
    err := client.ConvertUrlToFile("https://pdfcrowd.com/static/images/logo.png", "logo.jpg")

    // check for the conversion error
    handleError(err)
}

func handleError(err error) {
    if err != nil {
        why, ok := err.(pdfcrowd.Error)
        if ok {
            os.Stderr.WriteString(fmt.Sprintf("Pdfcrowd Error: %s\n", why))
        } else {
            os.Stderr.WriteString(fmt.Sprintf("Generic Error: %s\n", err))
        }

        panic(err.Error())
    }
}

package main

import (
    "os"
    "fmt"
    "github.com/pdfcrowd/pdfcrowd-go"
    "io/ioutil"
)

func readFile(fileName string) []byte {
    content, err := ioutil.ReadFile(fileName)
    handleError(err)
    return content
}

func main() {
    // create the API client instance
    client := pdfcrowd.NewImageToImageClient("your_username", "your_apikey")

    // configure the conversion
    client.SetOutputFormat("jpg")

    // run the conversion and write the result to a file
    err := client.ConvertRawDataToFile(readFile("/path/to/logo.png"), "logo.jpg")

    // check for the conversion error
    handleError(err)
}

func handleError(err error) {
    if err != nil {
        why, ok := err.(pdfcrowd.Error)
        if ok {
            os.Stderr.WriteString(fmt.Sprintf("Pdfcrowd Error: %s\n", why))
        } else {
            os.Stderr.WriteString(fmt.Sprintf("Generic Error: %s\n", err))
        }

        panic(err.Error())
    }
}

Authentication

The credentials to access the API are your Pdfcrowd username and the API key.

Error Handling

It is recommended that you implement error handling to catch errors that the API may return, see the example code below. A list of status codes and their description can be found here.

// call the API 

    // print the error
    os.Stderr.WriteString(fmt.Sprintf("Pdfcrowd Error: %s\n", why))

    // print the error code
    os.Stderr.WriteString(fmt.Sprintf("Pdfcrowd Error Code: %v\n", why.getCode()))

    // print the error message
    os.Stderr.WriteString(fmt.Sprintf("Pdfcrowd Error Message: %v\n", why.getMessage()))

Troubleshooting

Refer to the API Status Codes page if the API returns an error.
You can use setDebugLog and getDebugLogUrl to get detailed info about the conversion, such as load errors, load times, browser console output, etc.
Check the FAQ.
Contact us if you need help or are missing a feature.

API Method Reference

Refer to the Image to Image Golang Reference for a description of all API methods.