OpenAPI y otros lenguajes

La API completa se describe en un documento OpenAPI 3.1. Alimenta la referencia de la API de este sitio y permite generar clientes para lenguajes sin SDK oficial.

• Especificación: https://api.spacepost.dev/openapi.json
• Archivo fuente en el repositorio: openapi/openapi.yaml

Generar un cliente

Define la URL base como https://api.spacepost.dev y configura la autenticación bearer con tu clave sp_live_.

TypeScript

Tipos y un cliente fetch con openapi-typescript y openapi-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

Cualquier lenguaje

Usa OpenAPI Generator:

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

Existen generadores para PHP, Ruby, Java, Kotlin, Swift, C#, Rust y decenas más.

Consejo

Los clientes generados no saben que los errores comparten una misma forma, ni conocen Idempotency-Key. Añade ese encabezado a los encabezados por defecto de tu cliente o a los de cada petición donde lo necesites, y analiza los errores como { statusCode, name, message }.

Postman y herramientas de API

Importa la URL de la especificación en Postman, Insomnia, Bruno o Hoppscotch. Define una variable de colección para el token bearer.

Usa los SDK de Resend

Como SpacePost es compatible con Resend, los SDK oficiales de Resend en otros lenguajes suelen funcionar si se sobrescribe su URL base. Consulta Migrar desde Resend.

Referencia de la APICada endpoint con sus esquemas de petición y respuesta.