Consultar estado y resultado de un job

Devuelve el estado actual y, cuando finaliza, el resultado de un job asíncrono.

Los jobs se crean cuando un endpoint recibe el header x-async: true. Sondea este endpoint periódicamente hasta que status sea completed o failed.

Ejemplo de polling en JavaScript:

async function waitForJob(jobId, apiKey) {
  while (true) {
    const res = await fetch(`https://api.curpify.mx/v1/jobs/${jobId}`, {
      headers: { 'x-api-key': apiKey }
    });
    const { data } = await res.json();
    if (data.status === 'completed') return data.result;
    if (data.status === 'failed') throw new Error(data.error);
    await new Promise(r => setTimeout(r, 1000));
  }
}

Acepta autenticación mediante Bearer JWT o API Key (prefijo ck_).