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.