Uploadcare Golang API client that handles uploads and further operations with files by wrapping Uploadcare Upload and REST APIs.
go1.13
Install uploadcare-go with:
go get -u -v github.com/uploadcare/uploadcare-go/...
Then import it using:
import (
"github.com/uploadcare/uploadcare-go/ucare"
"github.com/uploadcare/uploadcare-go/file"
"github.com/uploadcare/uploadcare-go/group"
"github.com/uploadcare/uploadcare-go/upload"
"github.com/uploadcare/uploadcare-go/conversion"
)
Creating a client:
creds := ucare.APICreds{
SecretKey: "your-project-secret-key",
PublicKey: "your-project-public-key",
}
conf := &ucare.Config{
SignBasedAuthentication: true,
APIVersion: ucare.APIv06,
}
client, err := ucare.NewClient(creds, conf)
if err != nil {
log.Fatal("creating uploadcare API client: %s", err)
}
For a comprehensive list of examples, check out the API documentation. Below are a few usage examples:
Getting a list of files:
fileSvc := file.NewService(client)
listParams := file.ListParams{
Stored: ucare.String(true),
OrderBy: ucare.String(file.OrderBySizeAsc),
}
fileList, err := fileSvc.List(context.Background(), listParams)
if err != nil {
// handle error
}
// getting IDs of the files
ids := make([]string, 0, 100)
for fileList.Next() {
finfo, err := fileList.ReadResult()
if err != nil {
// handle error
}
ids = append(ids, finfo.ID)
}
Acquiring file-specific info:
fileID := ids[0]
file, err := fileSvc.Info(context.Background(), fileID)
if err != nil {
// handle error
}
if file.IsImage {
h := file.ImageInfo.Height
w := file.ImageInfo.Width
fmt.Printf("image size: %dx%d\n", h, w)
}
Uploading a file:
f, err := os.Open("file.png")
if err != nil {
// handle error
}
uploadSvc := upload.NewService(client)
params := upload.FileParams{
Data: f,
Name: f.Name(),
ContentType: "image/png",
}
fID, err := uploadSvc.File(context.Background(), params)
if err != nil {
// handle error
}
Golang API client documentation
Uploadcare documentation
Upload API reference
REST API reference
Changelog
Contributing guide
Security policy
Support