Saltar al contenido
Notificado
Menú
Crear cuenta

Evidencia

2 operaciones, cada una con sus parámetros, ejemplos en curl y TypeScript listos para copiar y sus errores.

Las operaciones marcadas /v1 se autentican con un token de agente; las demás, con una sesión del panel. Cómo funcionan ambas está en Autenticación

evidenceDownloadInfo

GET/v1/evidence-download-info

Miembro de la firmaPermiso: evidence:read/v1 · token BearerHerramienta MCP: evidenceDownloadInfo

Name, size and SHA-256 of the constancia or zip, and the HTTP call that downloads it (recorded there). Records nothing.

Parámetros de evidenceDownloadInfo
NombreDóndeTipoObligatorio
kindConsulta"constancia" | "zip"No
notificationIdConsultastring (uuid)Sí
orgIdConsultastring (uuid)Sí
versionConsultainteger 1–9007199254740991No
curl
curl 'https://www.notificado.co/v1/evidence-download-info?notificationId=<notificationId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"
TypeScript
const response = await fetch('https://www.notificado.co/v1/evidence-download-info?notificationId=<notificationId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();
Ejemplo de respuesta
200
{
  "bytes": 1,
  "constanciaId": "<constanciaId>",
  "contentType": "<contentType>",
  "fetch": {
    "body": {
      "kind": "constancia",
      "notificationId": "<notificationId>",
      "orgId": "<orgId>",
      "version": 1
    },
    "method": "POST",
    "path": "<path>"
  },
  "filename": "<filename>",
  "kind": "constancia",
  "newestState": "ready",
  "newestVersion": 1,
  "notificationId": "<notificationId>",
  "orgId": "<orgId>",
  "sha256": "<sha256>",
  "zipVersion": 1
}

Errores

  • 400 X_INPUT_INVALID
  • 401 X_UNAUTHENTICATED — no credential, or one that did not resolve
  • 403 policy denied
  • 404 X_NOT_FOUND — the read matched no row for this input
  • 429 X_RATE_LIMITED — retry after Retry-After seconds

downloadEvidence

POST/v1/download-evidence

Miembro de la firmaPermiso: evidence:read/v1 · token BearerHerramienta MCP: downloadEvidence

The constancia PDF or the evidence zip as bytes (base64), re-hashed first. Recorded as evidence.viewed.

Parámetros de downloadEvidence
NombreDóndeTipoObligatorio
kindCuerpo"constancia" | "zip"Sí
notificationIdCuerpostring (uuid)Sí
orgIdCuerpostring (uuid)Sí
versionCuerpointeger 1–9007199254740991No
curl
curl -X POST 'https://www.notificado.co/v1/download-evidence' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN" \
  -H 'content-type: application/json' \
  -d '{
  "kind": "constancia",
  "notificationId": "<notificationId>",
  "orgId": "<orgId>"
}'
TypeScript
const response = await fetch('https://www.notificado.co/v1/download-evidence', {
  method: 'POST',
  headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "kind": "constancia",
    "notificationId": "<notificationId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();
Ejemplo de respuesta
200
{
  "bytes": 0,
  "constanciaId": "<constanciaId>",
  "contentBase64": "<contentBase64>",
  "contentType": "<contentType>",
  "filename": "<filename>",
  "kind": "constancia",
  "newestState": "ready",
  "newestVersion": 1,
  "sha256": "<sha256>",
  "version": 1
}

Errores

  • 400 X_INPUT_INVALID
  • 401 X_UNAUTHENTICATED — no credential, or one that did not resolve
  • 403 policy denied
  • 422 X_BODY_INVALID
  • 429 X_RATE_LIMITED — retry after Retry-After seconds