Il Problema: La gestione opaca degli errori nelle API esterne
![]() |
| Immagine realizzata con Gemini AI |
Quando si inoltrano richieste verso un provider esterno come l'API v3 di Brevo (Sendinblue), limitarsi a verificare se il booleano response.ok restituisce true o false costituisce un serio debito architetturale. L'endpoint di Brevo risponde con codici di stato ben precisi: un 400 Bad Request (sintassi non conforme), un 409 Duplicate/Conflict (contatto già iscritto) o un 429 Too Many Requests (rate limit superato).
La Soluzione: Parsing Granulare dello Stato HTTP nel Worker
Il micro-proxy su Cloudflare Worker non deve agire come un semplice passacarte cieco, ma come un gateway intelligente capace di intercettare il corpo JSON della risposta upstream e rimapparlo su messaggi chiari per il front-end.
Architettura del Flusso di Risposta
export default {
async fetch(request, env) {
if (request.method === "OPTIONS") {
return new Response(null, {
headers: {
"Access-Control-Allow-Origin": "https://itchronicle.com",
"Access-Control-Allow-Methods": "POST, OPTIONS",
"Access-Control-Allow-Headers": "Content-Type"
}
});
}
if (request.method !== "POST") {
return new Response(JSON.stringify({ error: "Metodo non consentito" }), { status: 405 });
}
try {
const { email, lang, redirectUrl } = await request.json();
const templateId = lang === "en" ? 12 : 11;
const listId = lang === "en" ? 5 : 4;
const brevoPayload = {
email: email,
includeListIds: [listId],
templateId: templateId,
redirectionUrl: redirectUrl
};
const brevoResponse = await fetch("https://api.brevo.com/v3/contacts/doubleOptinConfirmation", {
method: "POST",
headers: {
"api-key": env.BREVO_API_KEY,
"Content-Type": "application/json",
"Accept": "application/json"
},
body: JSON.stringify(brevoPayload)
});
// Parsing sicuro del corpo di risposta
let data = {};
const responseText = await brevoResponse.text();
try {
data = JSON.parse(responseText);
} catch (e) {
data = { message: responseText };
}
if (!brevoResponse.ok) {
return new Response(JSON.stringify({
success: false,
status: brevoResponse.status,
code: data.code || "UPSTREAM_ERROR",
message: data.message || "Errore durante la comunicazione con Brevo"
}), {
status: brevoResponse.status,
headers: {
"Access-Control-Allow-Origin": "https://itchronicle.com",
"Content-Type": "application/json"
}
});
}
return new Response(JSON.stringify({ success: true }), {
status: 200,
headers: {
"Access-Control-Allow-Origin": "https://itchronicle.com",
"Content-Type": "application/json"
}
});
} catch (err) {
return new Response(JSON.stringify({ success: false, message: err.message }), {
status: 500,
headers: {
"Access-Control-Allow-Origin": "https://itchronicle.com",
"Content-Type": "application/json"
}
});
}
}
};
Indice: La Genesi di una Newsletter
- Ep. 1: Architettura Serverless con Cloudflare Workers e Brevo
- Ep. 2: Consolidamento Monorepo con Git Subtree e Delivery Decoupling
- Ep. 3: Cloudflare Workers, Protezione Anti-Spam e Rate Limiting a Livello Edge
- Ep. 4: Gestione Avanzata Errori Brevo API su Cloudflare Workers [Ti trovi qui]
La tua Ricompensa: Brevo API Integration & Error Toolkit
Scarica la suite completa di moduli JavaScript con gestione unificata dei codici di stato HTTP e messaggi localizzati per ambienti di produzione. Inserisci la tua email per ottenerla.
Inviando la richiesta, accetti di iscriverti alla newsletter tecnica di IT Chronicle. Zero spam, pura operatività.
