Vue integration
Use a small Vue composable around the public submission contract.
usePostvia.ts
import { ref } from 'vue'
export function usePostvia(publicId: string) {
const pending = ref(false)
const success = ref(false)
const error = ref<string | null>(null)
const fieldErrors = ref<Record<string, string[]>>({})
const key = ref(crypto.randomUUID())
async function submit(values: Record<string, unknown>) {
pending.value = true
success.value = false
error.value = null
fieldErrors.value = {}
try {
await $fetch(`https://api.postvia.dev/v1/forms/${publicId}/submissions`, {
method: 'POST',
headers: { Accept: 'application/json', 'Idempotency-Key': key.value },
body: values,
})
success.value = true
key.value = crypto.randomUUID()
} catch (exception: any) {
error.value = exception?.data?.error?.message ?? 'Submission failed'
fieldErrors.value = exception?.data?.error?.fields ?? {}
} finally {
pending.value = false
}
}
return { submit, pending, success, error, fieldErrors }
}
ContactForm.vue
<script setup lang="ts">
const { submit, pending, success, error, fieldErrors } = usePostvia('abc123')
const values = reactive({ name: '', email: '', message: '' })
</script>
<template>
<form @submit.prevent="submit(values)">
<label>Name <input v-model="values.name" autocomplete="name"></label>
<p v-if="fieldErrors.name" role="alert">{{ fieldErrors.name[0] }}</p>
<label>Email <input v-model="values.email" type="email" autocomplete="email"></label>
<label>Message <textarea v-model="values.message"></textarea></label>
<p v-if="error" role="alert">{{ error }}</p>
<p v-if="success" role="status">Your enquiry has been received.</p>
<button :disabled="pending">{{ pending ? 'Sending…' : 'Send' }}</button>
</form>
</template>
Keep the same idempotency key while the payload is unchanged. Rotate it after success or when the user edits the data.