fleetssl / cpanelgo

cPanel/WHM JSON and LiveAPI client for Go

cPanel api in Go

About

This is a simple cPanel api written in go.

Currently four intefaces are implemented,

• CGI cPanel LiveApi - Designed for use in plugins, this interface will work through the preauthenticated CGI LiveApi environment as documented here (UAPI/API2/API1)
• Authenticated JSON cPanel API (UAPI/API2/API1)
• WHM (WHMAPI1)
• WHM Impersonation to call cPanel API (UAPI/API2/API1)

Example

A simple command line example is provided in the example folder.

About

This API forms part of the Let's Encrypt for cPanel plugin which allows cPanel/WHM hosters to provide free Let's Encrypt certificates for their clients.

cpanelgo's Issues

export full backup tar.gz file from cPanel

hi,

i am not able to export full backup tar.gz file from cPanel using API2 and UAPI in GO.
actually there is no option export or download backup from cPanel using API2 and UAPI

kindly help thank you!

Create backup on Server (using PuTTY)

Hello, @alexzorin, I am able to access the files on the server using code in PuTTY by uploading the executable file of my code.
Now, Is there any way/function to create a full back-up using the same on the server that I'm using?

Unable to download the backup file using the API.

Hi, @alexzorin. I'm unable to download the backup file using this API. Is there any function available to do so? Could you please add such functionality in the API if no such exists?

It's urgent. Please reply ASAP.
Thanks in advance.

Allow for custom *http.Client to be passed to the upper clients

Currently, the *http.Client used for making the API calls are hard-coded inside the client different gateway implementations (e.g.: https://github.com/letsencrypt-cpanel/cpanelgo/blob/eb0532054299c19f6aad2f5445e25ea8ff44bbd2/cpanel/authenticated.go#L115)

I think there should be a way to pass an *http.Client that the user might want to use down to the gateway. An easy approach would be to pass the client into the gateway client constructors:

type JsonApiGateway struct {
	Hostname string
	Username string
	Password string
	Insecure bool
	cl       *http.Client
}

func NewJsonApi(hostname, username, password string, insecure bool, cl *http.Client) (CpanelApi, error) {
	c := &JsonApiGateway{
		Hostname: hostname,
		Username: username,
		Password: password,
		Insecure: insecure,
	}

        if cl != nil {
            c.cl = cl
        }

	return CpanelApi{cpanelgo.NewApi(c)}, nil
}

What do you think?