Base URL

Cada petición combina una base URL con una ruta bajo /public. Hay dos entornos disponibles: desarrollo y producción.

Servidores

Anatomía de una URL

No hay segmento de versión en la ruta. Los endpoints públicos viven todos bajo el prefijo /public:

https://api.draftin.io/public/posts/slug/mi-primer-post
└────────┬───────────┘└──┬──┘└───────────┬───────────┘
     base URL         prefijo     recurso + parámetros

Mapa de recursos públicos

Todas las rutas de abajo son relativas a la base URL de producción:

Protocolo

• Siempre HTTPS en producción. Las peticiones deben usar https://.
• JSON de extremo a extremo: el cuerpo de las respuestas es application/json. En peticiones con cuerpo (algunos endpoints de anuncios), envía Content-Type: application/json — cualquier otro valor resulta en 415 Unsupported Media Type.

const BASE = process.env.DRAFTIN_BASE_URL ?? "https://api.draftin.io";

const url = new URL("/public/posts", BASE);
url.searchParams.set("limit", "10");

await fetch(url, { headers: { "X-API-Key": process.env.DRAFTIN_API_KEY! } });