Zum Hauptinhalt springen
client := rest.NewClient(os.Getenv("SQUARECLOUD_API_KEY"))
defer client.Close()

api := rest.New(client)

​
Den Deploy-Verlauf auflisten

api.GetApplicationDeployments(appID) gibt [][]squarecloud.Deployment zurück — eine innere Slice pro Deploy. Jedes Event einer Gruppe teilt dieselbe ID (den Commit-SHA-1, 40 Hex-Zeichen) und durchläuft die Lebenszykluszustände: pending → clone → commit → restarting → success | error. 
history, err := api.GetApplicationDeployments("abc123def456abc123def456")
if err != nil {
	panic(err)
}

for _, timeline := range history {
	last := timeline[len(timeline)-1]
	fmt.Printf("Deploy %s ended as %s\n", last.ID, last.State)

	for _, event := range timeline {
		if event.State == "clone" {
			fmt.Println("  cloned branch", event.Branch)
		}
		if event.State == "commit" {
			fmt.Println("  files", event.Files.Added, event.Files.Removed, event.Files.Modified)
		}
	}
}
Branch ist nur beim Event "clone" befüllt und Files (Added, Removed, Modified) nur beim Event "commit".

​
Die aktuelle Konfiguration inspizieren

api.GetApplicationCurrentDeployment(appID) gibt einen squarecloud.DeploymentCurrent mit der aktuell konfigurierten GitHub-App-Verknüpfung zurück. 
current, err := api.GetApplicationCurrentDeployment("abc123def456abc123def456")
if err != nil {
	panic(err)
}

if current.App == nil {
	fmt.Println("no GitHub App linked")
} else {
	fmt.Println("linked to", current.App.FullName)
}

​
Verknüpfen über die Square Cloud GitHub App (empfohlen)

api.LinkApplicationGithubApp(appID, repoName, branch) verknüpft ein GitHub-Repository über die offizielle GitHub App mit der Anwendung. 
err := api.LinkApplicationGithubApp("abc123def456abc123def456", "octocat/hello-world", "main")
if err != nil {
	panic(err)
}
Um die Verknüpfung zu entfernen: 
err := api.UnlinkApplicationGithubApp("abc123def456abc123def456")
LinkApplicationGithubApp und UnlinkApplicationGithubApp erfordern ein Session-Token (JWT) als Zugangsdaten — einfache API-Schlüssel werden von diesen Endpoints nicht akzeptiert. Übergib es mit rest.WithToken(sessionToken) oder baue den Client damit.

​
Verknüpfen über den Legacy-Webhook-Flow

api.PostApplicationDeployWebhook(appID, accessToken) registriert ein GitHub Personal Access Token (ghp_* oder github_pat_*) und gibt die Webhook-URL zurück, die auf GitHub zu konfigurieren ist. 
webhookURL, err := api.PostApplicationDeployWebhook("abc123def456abc123def456", "ghp_xxx...")
if err != nil {
	panic(err)
}

fmt.Println("Configure GitHub to POST to:", webhookURL)
Übergib das Token "@", um den konfigurierten Webhook zu entfernen.
_, err := api.PostApplicationDeployWebhook("abc123def456abc123def456", "@")