IMAP Sincronizar buzones y mensajes (Guías) | Documentación de la API de Inbox Manager

IMAP Sincronizar buzones y mensajes

Propósito: poner en cola IMAP trabajos de sincronización y conservar metadatos de mensajes para flujos de búsqueda y lectura.

Flujo de interfaz de usuario

El usuario elige la credencial y la carpeta.
La interfaz de usuario pone en cola la sincronización del buzón o de los mensajes.
La interfaz de usuario sondea trabajos/tareas para determinar el estado terminal.
La interfaz de usuario se actualiza /api/accounts/:account_id/emails.

Flujo de la biblioteca del cliente

const mailboxTask = await api.provider.imap.syncMailboxes(accountId, {
  credential_id: imapCredentialId,
});
const messageTask = await api.provider.imap.syncMessages(accountId, {
  credential_id: imapCredentialId,
  folder: "INBOX",
});
await api.jobs.waitForTask(accountId, messageTask.data.task_id);
const emails = await api.emails.list(accountId, { limit: 20, offset: 0 });

Flujo HTTP/curl

API_BASE_URL="https://api.inbox-manager.com"

curl -sS -X POST "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/imap/sync-mailboxes" \
  -H "authorization: Bearer ${BEARER_TOKEN}" \
  -H "content-type: application/json" \
  --data "{\"credential_id\":\"${IMAP_CREDENTIAL_ID}\"}"

curl -sS -X POST "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/imap/sync-messages" \
  -H "authorization: Bearer ${BEARER_TOKEN}" \
  -H "content-type: application/json" \
  --data "{\"credential_id\":\"${IMAP_CREDENTIAL_ID}\",\"folder\":\"INBOX\"}"

curl -sS "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/jobs?limit=20" \
  -H "authorization: Bearer ${BEARER_TOKEN}"

curl -sS "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/emails?limit=20&offset=0" \
  -H "authorization: Bearer ${BEARER_TOKEN}"

Script de validación

scripts/provider_job_flow.sh