OpenAPI 및 기타 언어

전체 API는 OpenAPI 3.1 문서로 기술되어 있습니다. 이 사이트의 API 레퍼런스를 만드는 데 쓰이며, 공식 SDK가 없는 언어의 클라이언트를 생성하는 데도 사용할 수 있습니다.

• 명세: https://api.spacepost.dev/openapi.json
• 저장소의 소스 파일: openapi/openapi.yaml

클라이언트 생성

기본 URL을 https://api.spacepost.dev로 설정하고 sp_live_ 키로 bearer 인증을 구성하세요.

TypeScript

openapi-typescript와 openapi-fetch로 타입과 fetch 클라이언트를 만듭니다.

npx openapi-typescript https://api.spacepost.dev/openapi.json -o spacepost.d.ts
npm install openapi-fetch

import createClient from "openapi-fetch";
import type { paths } from "./spacepost";

const client = createClient<paths>({
  baseUrl: "https://api.spacepost.dev",
  headers: { Authorization: `Bearer ${process.env.SPACEPOST_API_KEY}` },
});

const { data, error } = await client.POST("/emails", {
  body: { from: "Acme <hello@acme.com>", to: ["user@example.com"], subject: "Hi", html: "<p>Hi</p>" },
});

Python

pipx install openapi-python-client
openapi-python-client generate --url https://api.spacepost.dev/openapi.json

Go

go install github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen@latest
curl -s https://api.spacepost.dev/openapi.json -o openapi.json
oapi-codegen -package spacepost -generate types,client openapi.json > spacepost.gen.go

모든 언어

OpenAPI Generator를 사용하세요.

npx @openapitools/openapi-generator-cli generate \
  -i https://api.spacepost.dev/openapi.json \
  -g ruby -o ./spacepost-ruby

PHP, Ruby, Java, Kotlin, Swift, C#, Rust 등 수십 가지 언어의 생성기가 있습니다.

팁

생성된 클라이언트는 오류가 하나의 형식을 공유한다는 점이나 Idempotency-Key를 알지 못합니다. 필요한 곳에서 클라이언트의 기본 헤더나 요청별 헤더에 이 헤더를 추가하고, 오류는 { statusCode, name, message }로 파싱하세요.

Postman 및 API 도구

명세 URL을 Postman, Insomnia, Bruno, Hoppscotch로 가져오세요. 컬렉션 변수에 bearer 토큰을 설정합니다.

Resend SDK 사용하기

SpacePost는 Resend와 호환되므로 다른 언어의 공식 Resend SDK도 기본 URL을 바꾸는 것만으로 동작하는 경우가 많습니다. Resend에서 마이그레이션을 참고하세요.

API 레퍼런스요청 및 응답 스키마와 함께 제공되는 모든 엔드포인트.