Integriere Go-Anwendungen mithilfe generierter, typisierter Clientmethoden in die APIs von PostGrid für Druck und Postversand sowie Adressprüfung.
Installieren & Herunterladen
1. ClawHub CLI
Der schnellste Weg, einen Skill direkt aus der Registry zu installieren.
npx clawhub@latest install go-postgrid
2. Manuelle Installation
Kopiere den Skill-Ordner an einen dieser Orte
~/.openclaw/skills/ <project>/skills/ Priorität: Workspace > Lokal > Integriert (Bundled)
3. Prompt-Installation
Kopiere diesen Prompt in OpenClaw, um ihn automatisch zu installieren.
Hilf mir, go-postgrid über Clawhub zu installieren. Falls Clawhub nicht installiert ist, installiere es bitte zuerst (npm i -g clawhub).
Lieber herunterladen?
Hole dir die rohen Skill-Dateien in einem ZIP-Archiv.
Was ist go-postgrid?
go-postgrid ist ein inoffizieller Go-Client für PostGrid, der im Paket postgrid unter github.com/psyb0t/go-postgrid bereitgestellt wird. Er wurde mit oapi-codegen generiert und bietet typisierte Methoden für Kontakte, Vorlagen, Briefe, Postkarten, Schecks, Self-Mailer, Kampagnen, Mailinglisten, Berichte, webhook und Adressprüfung.
Dieser Openclaw-Skills-Eintrag hilft Go-Entwicklern dabei, das Paket zu finden, die API-key-Authentifizierung einzurichten und die generierten Endpoint-Signaturen und Antworttypen zu verwenden. Der Client liest und schreibt keine Dateien. Gehe sorgfältig mit produktiven Postvorgängen um: Mit einem produktiven key können physische Sendungen verschickt werden und Kosten entstehen.
go-postgrid Anwendungsfälle
- PostGrid-Vorgänge für Kontakte, Vorlagen, Briefe, Postkarten, Schecks, Self-Mailer, Kampagnen, Mailinglisten, Berichte oder webhook zu einer Go-Anwendung hinzufügen.
- Standard-, internationale, stapelweise oder umfangreiche Adressprüfungen aus Go-Code durchführen.
- In einem Projekt arbeiten, das bereits
github.com/psyb0t/go-postgridimportiert, und generierte Methoden oder Modelle untersuchen müssen. - PostGrid-Integrationen mit einem Test-API-key und einem lokalen HTTP-Server entwickeln und testen, ohne produktive Sendungen zu verschicken.
So funktioniert go-postgrid
- Stelle sicher, dass das Projekt in Go geschrieben ist, und füge
github.com/psyb0t/go-postgridals Modulabhängigkeit hinzu. - Sieh dir die Dokumentation des generierten Pakets und die Methodensignaturen an, statt Endpoint-Namen, Parameter oder Modellfelder zu erraten.
- Konfiguriere einen Client mit
postgrid.WithRequestEditorFnund setze den HeaderX-API-Keyanhand der UmgebungsvariablePOSTGRID_API_KEY. - Erstelle den Client mit der passenden PostGrid-API-Basis-URL
https://api.postgrid.comund rufe eine generierteWithResponse-Methode mit dem erforderlichen Kontext, den Pfadparametern, optionalen Parametern und dem Anforderungstext auf. - Prüfe vor der Verwendung der decodierten Antwort die Transport- und Decodierungsfehler, den HTTP-Statuscode und das zugehörige statusbezogene Antwortfeld, beispielsweise
JSON200oderJSON201. - Kompiliere und teste den aufrufenden Code mit einem lokalen HTTP-Server. Verwende während der Entwicklung einen Test-key und wiederhole eine unsichere Anfrage zum Erstellen einer Sendung erst, nachdem du geprüft hast, ob die erste Anfrage erfolgreich war.
go-postgrid Einrichtung
Installiere die Go-Toolchain und füge das Modul in deinem Go-Projekt hinzu:
go get github.com/psyb0t/go-postgrid
Lege POSTGRID_API_KEY außerhalb des Quellcodes fest; hardcode den key niemals, committe ihn nicht und schreibe ihn nicht in Logs. Das Client-Beispiel verwendet WithRequestEditorFn, um ihn in den Anfrage-Header X-API-Key einzufügen. Wähle passende Zugangsdaten für die aufgerufene PostGrid-API und verwende während der Entwicklung einen Test-key.
Sieh in der Paketdokumentation nach, um Endpoint-Methoden und Typen zu finden:
go doc github.com/psyb0t/go-postgrid ClientWithResponsesInterface
go doc github.com/psyb0t/go-postgrid ContactsListParams
go doc -all github.com/psyb0t/go-postgrid
Die Paketdokumentation ist auch unter https://pkg.go.dev/github.com/psyb0t/go-postgrid verfügbar. Kompiliere den Code nach der Implementierung eines Aufrufs und teste ihn mit einem lokalen HTTP-Server. Tests dürfen PostGrid nicht aufrufen und keine produktiven Sendungen erstellen.
go-postgrid Datenschema & Taxonomie
Das Paket wird aus einer API-Spezifikation generiert und stellt typisierte Go-Methoden und -Modelle bereit. Das Skill definiert keinen separaten Datenspeicher und generiert keine Anwendungsdatendateien.
- Paket:
postgridim Modulstammverzeichnisgithub.com/psyb0t/go-postgrid. - Endpoint-Methoden: Generierte Operations-IDs werden zu Methoden, die üblicherweise
<OperationId>WithResponseheißen. Methoden erwarten einen Kontext, Pfadparameter in der vorgegebenen Reihenfolge, gegebenenfalls optionale*<OperationId>Paramsund, falls erforderlich, einen Anforderungstext. - Anfrage- und Antworttypen: Generierte Parameter- und Modelltypen beschreiben Endpoint-Eingaben und decodierte Antworttexte. Optionale Modellfelder können Zeiger sein und sollten vor dem Dereferenzieren geprüft werden.
- Antwortverarbeitung: Statusbezogene Felder wie
JSON200oderJSON201enthalten decodierte Inhalte für den angegebenen Status; bei anderen Statuswerten sind diese Felder nil. Prüfe zusätzlich zum Go-Fehler auchStatusCode(), da ein HTTP-Fehler nicht unbedingt einen von nil verschiedenen Go-Fehler erzeugt. - Authentifizierungsmetadaten: Sende den API key im Header
X-API-Key. Bewahre ihn in der UmgebungsvariablePOSTGRID_API_KEYund nicht im Quellcode auf. - Dateien: Die Bibliothek liest und schreibt keine Dateien. Das Skill unterstützt bei Änderungen am Go-Quellcode im aktuellen Projekt.
go-postgrid Erweiterte Funktionen
- Die generierten typisierten Methoden decken die Vorgänge der API-Spezifikation ab. Verwende
go docoder pkg.go.dev, um genaue Signaturen und Go-Dokumentationsbeschreibungen zu finden. - Unterstützt Vorgänge mit mehreren Anfrageformaten, darunter JSON- und multipart-Endpoints, deren generierte Methodennamen Operations-IDs kombinieren können.
- Richte die Authentifizierung über den Anfrage-Editor-Hook
WithRequestEditorFnein. So kann der API key aus der Umgebung gelesen und jeder Anfrage hinzugefügt werden. - Wähle den passenden API key für die aufgerufene PostGrid-API. Die Spezifikation verwendet getrennte Sicherheitsschemata für Druck und Postversand sowie für die Adressprüfung.
- Verwende statusbezogene Antwortfelder und Zeigerprüfungen für eine robuste Antwortverarbeitung und teste den aufrufenden Code mit einem lokalen HTTP-Server.
- Beachte die betrieblichen Schutzmaßnahmen: Erstelle, versende, storniere oder lösche Ressourcen nur auf entsprechende Aufforderung. Wiederhole das Erstellen einer Sendung nach einer unklaren Antwort erst, wenn das ursprüngliche Ergebnis geprüft wurde.
SKILL.md
Laden
Verwandte Openclaw-Skills
go-zeroentropy
Integrieren Sie ZeroEntropy-Suche, Reranking, Embeddings und Kontovorgänge mit einem aus der öffentlichen API-Spezifikation generierten typisierten Client in Go-Anwendungen.
SafetyCard
SafetyCard überprüft den Quellcode eines AI Agent und erstellt einen überprüfbaren, tiefenverteidigten (defense-in-depth) Sicherheitswert mit umsetzbaren Belegen.
go-deribit
Verwenden Sie go-deribit, um Go-Anwendungen zu erstellen, die über typisierte Clients auf Deribit-REST-Endpunkte und WebSocket-Abonnementkanäle zugreifen.
tcr for OpenClaw
Verwende tcr mit OpenClaw, um Claude- und ChatGPT-Anfragen über deinen eigenen lokalen Pool von Abonnementkonten weiterzuleiten und zu überprüfen, ob beide Anbieter Gesprächsrunden bearbeiten.
go-surge
go-surge ist ein inoffizieller, typisierter Go-Client, der Anwendungen strukturierten Zugriff auf die Surge SMS API ermöglicht.
go-twelvedata
Ein typisierter Go-Client, der Anwendungen einen sicheren, strukturierten Zugriff auf Twelve Data-Marktpreise, -Kurse, -Zeitreihen, -Indikatoren, -Fundamentaldaten und -Batch-Abfragen ermöglicht.