統合ガイド · ASTRO & Jamstack
Astro コンタクト フォームの統合 (静的および SSR)
電子メール サーバーやデータベースを維持せずに、Lugatu エンドポイントを使用して問い合わせフォームを Astro 静的サイト (SSG) およびハイブリッド サーバー ルートに追加する方法。
1. 純粋な静的サイト (SSG) フォームの取り込み
Astro はデフォルトで JavaScript を使用しないことで有名です。 Lugatu を使用すると、Astro サイトを 100% 静的に保ちながら、標準の HTML フォームと軽量のクライアント側フェッチで問い合わせを収集できます。
src/pages/contact.astro
astro
---
// src/pages/contact.astro
---
<form id="astro-contact-form" class="space-y-4 max-w-md">
<div>
<label class="block text-sm font-semibold mb-1">Your Name</label>
<input type="text" name="name" required class="w-full border rounded-xl p-2.5" />
</div>
<div>
<label class="block text-sm font-semibold mb-1">Email Address</label>
<input type="email" name="email" required class="w-full border rounded-xl p-2.5" />
</div>
<div>
<label class="block text-sm font-semibold mb-1">Message</label>
<textarea name="message" rows="4" required class="w-full border rounded-xl p-2.5"></textarea>
</div>
<input type="text" name="_gotcha" style="display:none !important" tabindex="-1" autocomplete="off" />
<button type="submit" class="btn-primary-editorial py-2.5 px-6">Send Message</button>
</form>
<script>
const form = document.getElementById('astro-contact-form') as HTMLFormElement;
form?.addEventListener('submit', async (e) => {
e.preventDefault();
const formData = new FormData(form);
const payload = {
fields: {
name: formData.get('name'),
email: formData.get('email'),
message: formData.get('message'),
},
honeypot: formData.get('_gotcha') || '',
};
const res = await fetch('https://www.lugatu.com/api/v1/public/forms/YOUR_PUBLIC_FORM_ID/submissions', {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'Accept': 'application/json' },
body: JSON.stringify(payload),
});
if (res.ok) {
alert('Thank you! Message delivered.');
form.reset();
}
});
</script>
2. サーバー API キーを使用した Astro ハイブリッド / SSR API ルート
Astro サイトが Cloudflare Pages、Netlify、または Vercel のハイブリッドまたは SSR モードで実行されている場合は、Astro API ルートを通じて送信を安全に転送します。
src/pages/api/contact.ts
typescript
import type { APIRoute } from 'astro';
export const POST: APIRoute = async ({ request }) => {
const data = await request.formData();
const fields = {
name: data.get('name')?.toString(),
email: data.get('email')?.toString(),
message: data.get('message')?.toString(),
};
const res = await fetch(`https://www.lugatu.com/api/v1/forms/${import.meta.env.LUGATU_FORM_ID}/submissions`, {
method: 'POST',
headers: {
'Authorization': `Bearer ${import.meta.env.LUGATU_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({ fields }),
});
return new Response(JSON.stringify({ success: res.ok }), {
status: res.status,
headers: { 'Content-Type': 'application/json' },
});
};
セキュリティと認証の不変性
セキュリティに関する指示: Astro クライアント側スクリプト タグで import.meta.env.LUGATU_API_KEY を公開しないでください。 クライアント スクリプトはパブリック エンドポイントのみを使用する必要があります。
トラブルシューティングと一般的な取り込みエラー
フォームはローカルでは動作しますが、本番環境の Cloudflare / Netlify ビルドでは失敗します
運用環境変数 (LUGATU_FORM_ID および LUGATU_API_KEY) がホスティング ダッシュボードで構成されていることを確認します。
よくある質問
Lugatu を使用して Astro サイトを 100% 静的な状態に保つことはできますか?
はい。 純粋な静的 (SSG) サイトは、ホスティング プロバイダーのサーバー コンピューティングを必要とせずに、Lugatu パブリック エンドポイントに直接送信します。
フォームエンドポイントを作成する準備はできましたか?
数秒で無料で始められます。 クレジットカードは必要ありません。