Sponsored by Designkit Free Background Remover - Designkit은 하루 최대 100장의 이미지에서 배경을 무료로 제거할 수 있는 AI 서비스로, 일괄 처리와 배경 변경, 크기 조정 기능을 제공합니다.

AI 광고 라이브러리

Openclaw Skills

go-postgrid

Openclaw용 go-postgrid

생성된 타입 지정 클라이언트 메서드를 사용해 Go 애플리케이션을 PostGrid의 인쇄 및 우편 발송, 주소 확인 API와 통합합니다.

psyb0t

v0.1.1

Oct 18, 2026

설치

정보

Skill.md

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.


                  npx clawhub@latest install go-postgrid

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌

~/.openclaw/skills/

워크스페이스

<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.


                  Clawhub를 사용해서 go-postgrid 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

go-postgrid란 무엇인가요?

go-postgrid는 PostGrid용 비공식 Go 클라이언트로, github.com/psyb0t/go-postgrid의 postgrid 패키지에서 제공됩니다. oapi-codegen으로 생성되었으며 연락처, 템플릿, 편지, 엽서, 수표, 셀프 메일러, 캠페인, 메일링 리스트, 보고서, webhook 및 주소 확인을 위한 타입 지정 메서드를 제공합니다.

이 Openclaw Skills 항목은 Go 개발자가 패키지를 찾고, API key 인증을 구성하고, 생성된 엔드포인트 시그니처와 응답 유형을 사용하는 데 도움을 줍니다. 클라이언트는 파일을 읽거나 쓰지 않습니다. 실제 우편 작업은 신중하게 처리하세요. 실제 운영 key를 사용하면 실물 우편물이 발송되고 요금이 발생할 수 있습니다.

go-postgrid 활용 사례

Go 애플리케이션에 PostGrid 연락처, 템플릿, 편지, 엽서, 수표, 셀프 메일러, 캠페인, 메일링 리스트, 보고서 또는 webhook 작업을 추가합니다.
Go 코드에서 일반 주소, 국제 주소, 배치 주소 또는 대량 주소를 확인합니다.
이미 github.com/psyb0t/go-postgrid를 가져오는 프로젝트에서 생성된 메서드나 모델을 확인합니다.
테스트 API key와 로컬 HTTP 서버를 사용해 실제 우편물을 발송하지 않고 PostGrid 통합을 개발하고 테스트합니다.

go-postgrid 작동 원리

프로젝트가 Go로 작성되었는지 확인하고 github.com/psyb0t/go-postgrid를 모듈 종속 항목으로 추가합니다.
엔드포인트 이름, 매개변수 또는 모델 필드를 추측하지 말고 생성된 패키지 문서와 메서드 시그니처를 확인합니다.
postgrid.WithRequestEditorFn으로 클라이언트를 구성하고, POSTGRID_API_KEY 환경 변수의 값을 X-API-Key 헤더에 설정합니다.
적절한 PostGrid API 기본 URL인 https://api.postgrid.com을 사용해 클라이언트를 생성한 다음, 필요한 컨텍스트, 경로 매개변수, 선택적 매개변수 및 요청 본문을 전달하여 생성된 WithResponse 메서드를 호출합니다.
디코딩된 응답을 사용하기 전에 전송 및 디코딩 오류, HTTP 상태 코드, 그리고 JSON200 또는 JSON201과 같은 해당 상태별 응답 필드를 확인합니다.
로컬 HTTP 서버를 대상으로 호출 코드를 컴파일하고 테스트합니다. 개발 중에는 테스트 key를 사용하고, 우편물 생성 요청의 성공 여부가 확실하지 않다면 첫 요청의 성공 여부를 확인하기 전까지 반복하지 마세요.

go-postgrid 설정 가이드

Go 도구 체인을 설치하고 Go 프로젝트 내에서 모듈을 추가합니다.

go get github.com/psyb0t/go-postgrid

소스 코드 외부에서 POSTGRID_API_KEY를 설정하세요. key를 하드코딩하거나 커밋하거나 로그에 기록하지 마세요. 클라이언트 예제는 WithRequestEditorFn을 사용해 이를 X-API-Key 요청 헤더에 넣습니다. 호출하려는 PostGrid API에 적합한 자격 증명을 선택하고 개발 중에는 테스트 key를 사용하세요.

엔드포인트 메서드와 유형을 찾으려면 패키지 문서를 확인하세요.

go doc github.com/psyb0t/go-postgrid ClientWithResponsesInterface
go doc github.com/psyb0t/go-postgrid ContactsListParams
go doc -all github.com/psyb0t/go-postgrid

패키지 문서는 https://pkg.go.dev/github.com/psyb0t/go-postgrid에서도 확인할 수 있습니다. 호출을 구현한 후 코드를 컴파일하고 로컬 HTTP 서버를 대상으로 테스트하세요. 테스트에서 PostGrid를 호출하거나 실제 우편물을 생성해서는 안 됩니다.

go-postgrid 데이터 스키마 및 분류 체계

이 패키지는 API 사양에서 생성되며 타입 지정 Go 메서드와 모델을 제공합니다. skill은 별도의 데이터 저장소를 정의하거나 애플리케이션 데이터 파일을 생성하지 않습니다.

패키지: 모듈 루트 github.com/psyb0t/go-postgrid의 postgrid.
엔드포인트 메서드: 생성된 작업 ID는 메서드가 되며, 일반적으로 <OperationId>WithResponse라는 이름이 지정됩니다. 메서드는 컨텍스트, 순서대로 된 경로 매개변수, 해당하는 경우 선택적 *<OperationId>Params, 그리고 필요한 경우 요청 본문을 받습니다.
요청 및 응답 유형: 생성된 매개변수 및 모델 유형은 엔드포인트 입력과 디코딩된 응답 본문을 설명합니다. 선택적 모델 필드는 포인터일 수 있으므로 역참조하기 전에 확인해야 합니다.
응답 처리: JSON200 또는 JSON201과 같은 상태별 필드에는 선언된 상태에 대한 디코딩된 본문이 포함되며, 다른 상태에서는 nil입니다. HTTP 오류가 nil이 아닌 Go 오류를 발생시키지 않을 수도 있으므로 Go 오류뿐만 아니라 StatusCode()도 확인하세요.
인증 메타데이터: X-API-Key 헤더에 API key를 보냅니다. 소스 코드가 아니라 POSTGRID_API_KEY 환경 변수에 보관하세요.
파일: 라이브러리는 파일을 읽거나 쓰지 않습니다. skill은 현재 프로젝트의 Go 소스 편집을 안내합니다.

go-postgrid 고급 기능

생성된 타입 지정 메서드는 API 사양의 작업을 다룹니다. 정확한 시그니처와 Go 문서 설명을 확인하려면 go doc 또는 pkg.go.dev를 사용하세요.
JSON 및 multipart 엔드포인트를 비롯해 여러 요청 형식을 사용하는 작업을 지원하며, 생성된 메서드 이름에 여러 작업 ID가 결합될 수 있습니다.
요청 편집기 훅 WithRequestEditorFn을 통해 인증을 구성하면 환경 변수에서 API key를 읽어 각 요청에 추가할 수 있습니다.
호출할 PostGrid API에 맞는 API key를 선택하세요. 사양은 인쇄 및 우편 발송과 주소 확인에 서로 다른 보안 체계를 사용합니다.
상태별 응답 필드와 포인터 확인을 사용해 응답을 견고하게 처리하고, 로컬 HTTP 서버를 대상으로 호출 코드를 테스트하세요.
운영 안전 조치를 준수하세요. 요청이 있을 때만 리소스를 생성, 발송, 취소 또는 삭제하고, 결과가 불확실한 우편물 생성은 원래 요청의 결과를 확인할 때까지 재시도하지 마세요.