Galon Cloud
Galon API v1

Galon Cloud integrieren

Erstellen Sie ein Projekt, geben Sie einen API-Schlüssel mit minimalen Rechten aus, ermitteln Sie erlaubte Werkzeuge und rufen Sie die API von Ihrem Server auf.

Schnellstart

Melden Sie sich an, erstellen Sie ein Testprojekt und einen Schlüssel nur mit den benötigten Berechtigungen, rufen Sie GET /v1/tools auf, konfigurieren Sie einen Dienst und erstellen Sie nach dem Abnahmetest einen getrennten live-Schlüssel.

export GALON_API_BASE="https://api.galon.ai"
export GALON_API_KEY="gln_test_..."

curl "$GALON_API_BASE/v1/tools"   -H "Authorization: Bearer $GALON_API_KEY"

Authentifizierung und Isolation

Senden Sie den API-Schlüssel im Header Authorization: Bearer. Jeder Schlüssel ist genau einem Mandanten, Projekt und einer Umgebung zugeordnet. Speichern Sie ihn nur im serverseitigen Secret Manager, niemals im Browser, in einer mobilen App oder im Quellcode.

Auf Dienste begrenzte Schlüssel

Vergeben Sie genaue Berechtigungen wie mail:send, domain:lookup oder build:create. Verwenden Sie einen Schlüssel pro Anwendung. Vermeiden Sie Dienst-Wildcards, außer die Integration benötigt wirklich alle Vorgänge, und widerrufen Sie ungenutzte Schlüssel sofort.

mail:send
domain:lookup
domain:read
build:create
build:read
artifact:read
job:read

Asynchrone Jobs und Idempotenz

Änderungen liefern einen Job. Senden Sie einen stabilen Idempotency-Key: derselbe Schlüssel mit derselben Absicht liefert denselben Job, mit einer anderen Absicht HTTP 409. Fragen Sie den Job ab und wiederholen Sie nur sichere oder idempotente Anfragen.

POST /v1/jobs
GET  /v1/jobs/{job_id}
POST /v1/jobs/{job_id}/cancel
GET  /v1/builds/{job_id}/artifacts

E-Mails senden

POST /v1/emails nimmt from_email, subject, text oder html sowie to an: eine Adresse oder eine Liste. cc und bcc sind optionale Listen; to, cc und bcc zusammen umfassen höchstens 50 verschiedene Empfänger, und jeder Empfänger zählt für Ihr Kontingent und Ihre abgerechnete Nutzung. Jeder Empfänger erhält eine eigene Kopie mit seinem eigenen Ein-Klick-Abmeldelink, daher werden bcc-Empfänger nie offengelegt; gesperrte Empfänger (Bounces, Beschwerden, Abmeldungen) werden übersprungen. attachments ist eine Liste von höchstens 10 Objekten mit filename, content (Base64) und optionalem content_type; die kodierte Nachricht muss unter 25 MB bleiben, ausführbare Dateien werden abgelehnt. scheduled_at (ISO 8601 mit Zeitzone, höchstens 72 Stunden im Voraus) verschiebt den Versand; POST /v1/emails/{job_id}/cancel storniert ihn, solange er in der Warteschlange ist. POST /v1/emails/batch nimmt {"emails": [...]} mit 1 bis 100 Nachrichten ohne Anhänge an; jede Nachricht wird ein eigener Job, idempotent über den Idempotency-Key des Stapels und ihre Position. to_email wird für einen einzelnen Empfänger weiterhin akzeptiert. Nur die Registrierung des Stapels ist atomar (atomic=true); Ausführung und Zustellung sind unabhängig. Eine Wiederholung erfordert genau dieselbe geordnete Liste; jede Änderung an Inhalt, Größe oder Reihenfolge liefert HTTP 409.

POST /v1/emails
POST /v1/emails/batch
POST /v1/emails/{job_id}/cancel

Fehler

Behandeln Sie HTTP 401 als ungültige oder abgelaufene Zugangsdaten, 403 als fehlende Berechtigung, 409 als Idempotenz- oder Versionskonflikt, 422 als ungültige Anfrage und 503 als vorübergehende Nichtverfügbarkeit.

Maschinenlesbare Referenz

Verwenden Sie den OpenAPI-Vertrag für Schemas und den LLM-Integrationsleitfaden für Agentenanweisungen. Englisch ist maßgeblich; Pfade, Felder, Berechtigungen und Beispiele sind in jeder Übersetzung identisch.