SSE Streaming
SSE Streaming
De Career API ondersteunt Server-Sent Events (SSE) streaming voor AI-gestuurde endpoints. Hiermee ontvang je resultaten in realtime terwijl ze worden gegenereerd.
Streaming Endpoints
| Endpoint | Beschrijving |
|---|---|
POST /v1/tailor | Suggesties voor cv-optimalisatie |
POST /v1/cover-letters/generate | Genereren van motivatiebrieven |
Hoe In Te Schakelen
Voeg Accept: text/event-stream toe aan je verzoek-headers:
curl https://api.laddro.com/v1/tailor \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: text/event-stream" \
-d '{
"resumeId": "res_abc123",
"jobDescription": "..."
}'Event Formaat
Events volgen de SSE-specificatie:
data: {"type":"section","section":"summary","content":"Experienced engineer..."}
data: {"type":"section","section":"experience","content":"..."}
data: {"type":"done"}Elk event is een JSON-object met:
| Veld | Type | Beschrijving |
|---|---|---|
type | string | section of done |
section | string | Naam van de cv-sectie (wanneer type is section) |
content | string | Gegenereerde inhoud |
Implementatievoorbeelden
JavaScript (Browser)
const response = await fetch('https://api.laddro.com/v1/tailor', {
method: 'POST',
headers: {
'x-api-key': apiKey,
'Content-Type': 'application/json',
'Accept': 'text/event-stream'
},
body: JSON.stringify({ resumeId, jobDescription })
})
const reader = response.body.getReader()
const decoder = new TextDecoder()
while (true) {
const { done, value } = await reader.read()
if (done) break
const text = decoder.decode(value)
const lines = text.split('\n')
for (const line of lines) {
if (line.startsWith('data: ')) {
const event = JSON.parse(line.slice(6))
if (event.type === 'done') return
console.log(event.section, event.content)
}
}
}TypeScript SDK
for await (const event of client.tailor(
{ resumeId, jobDescription },
{ stream: true }
)) {
console.log(event.section, event.content)
}Python SDK
for event in client.tailor(
resume_id=resume_id,
job_description=jd,
stream=True
):
print(event.section, event.content)Node.js (Raw)
import { createParser } from 'eventsource-parser'
const response = await fetch('https://api.laddro.com/v1/tailor', {
method: 'POST',
headers: {
'x-api-key': process.env.LADDRO_API_KEY,
'Content-Type': 'application/json',
'Accept': 'text/event-stream'
},
body: JSON.stringify({ resumeId, jobDescription })
})
const parser = createParser(event => {
if (event.type === 'event') {
const data = JSON.parse(event.data)
if (data.type === 'done') return
process.stdout.write(data.content)
}
})
for await (const chunk of response.body) {
parser.feed(new TextDecoder().decode(chunk))
}Foutafhandeling
Als er een fout optreedt tijdens streaming, zendt de stream een fout-event uit:
data: {"type":"error","message":"Rate limit exceeded","statusCode":429}Verwerk altijd het fout-eventtype in je stream-consumer.