nady4 / desarrolladores
La superficie de API pública de nady4.com: documentación, spec OpenAPI y recursos legibles por máquinas.
01 / Inicio rápido
La API es pública y no requiere clave, registro ni OAuth. Podés empezar de inmediato:
curl -X POST https://www.nady4.com/api/newsletter \
-H "Content-Type: application/json" \
-d '{"email":"[email protected]"}'Respuesta exitosa: { "ok": true }
02 / Endpoint
POST /api/newsletter
- Suscribe una dirección de correo a la lista del newsletter.
- Cuerpo (JSON):
{"email": "[email protected]"} - Idempotente: suscribir el mismo correo dos veces no genera duplicados.
Formato de errores
Todos los errores son JSON con un código estable y una sugerencia de resolución:
{
"ok": false,
"message": "invalid_email",
"error": {
"code": "invalid_email",
"message": "The 'email' field is missing or not a valid email address.",
"hint": "Use a valid address like [email protected] (max 254 characters)."
}
}Códigos posibles: invalid_body, invalid_email, method_not_allowed, not_found, storage_failure.
03 / Spec y referencia
- OpenAPI 3.1: /openapi.json · /openapi.yaml — la definición completa de la API para herramientas y agentes.
- RFC 9728: /.well-known/oauth-protected-resource — metadatos del recurso protegido y alcances declarados.
- llms.txt: /llms.txt — guía del sitio para agentes.
- Sitemap: /sitemap.xml — todas las URLs indexables.
04 / Sandbox y límites
No hay entorno de staging separado: el endpoint de producción es también el sandbox, por lo que podés probar con tu propio correo sin riesgo. No hay límite de tasa documentado en el borde; si planeás suscribir muchos correos, avisá por [email protected].
El contenido del sitio está licenciado como CC BY-SA 4.0; la API no requiere autenticación y todos los alcances declarados están vacíos por diseño (ver metadatos RFC 9728).