Streaming SSE
Streaming SSE
La Career API soporta streaming de Server-Sent Events (SSE) para endpoints con IA. Esto te permite recibir resultados en tiempo real a medida que se generan.
Endpoints con streaming
| Endpoint | Descripcion |
|---|---|
POST /v1/tailor | Sugerencias de personalizacion de curriculo |
POST /v1/cover-letters/generate | Generacion de carta de presentacion |
Como habilitarlo
Agrega Accept: text/event-stream a los headers de tu solicitud:
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": "..."
}'Formato de eventos
Los eventos siguen la especificacion SSE:
data: {"type":"section","section":"summary","content":"Experienced engineer..."}
data: {"type":"section","section":"experience","content":"..."}
data: {"type":"done"}Cada evento es un objeto JSON con:
| Campo | Tipo | Descripcion |
|---|---|---|
type | string | section o done |
section | string | Nombre de la seccion del curriculo (cuando type es section) |
content | string | Contenido generado |
Ejemplos de implementacion
JavaScript (Navegador)
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))
}Manejo de errores
Si ocurre un error durante el streaming, el stream emitira un evento de error:
data: {"type":"error","message":"Rate limit exceeded","statusCode":429}Siempre maneja el tipo de evento de error en tu consumidor de stream.