PASE API v1

Descripción general

PASE API permite a organizaciones autorizadas consultar el estado de formación de personas registradas en la plataforma PASE y descargar los certificados emitidos en formato PDF.

La integración se basa en dos operaciones:

• Consulta de estado: enviás una lista de DNIs y recibís los cursos completados y certificados disponibles para cada persona.
• Descarga de PDF: con el token de descarga obtenido en la consulta, descargás el PDF de cada certificado individualmente.

Convenciones

Autenticación

Todos los endpoints requieren un Bearer token en el header Authorization. Cada organización cliente recibe un token único que no debe compartirse ni exponerse en código del lado del cliente.

# Header requerido en cada request
Authorization: Bearer {tu_token}

Obtención de credenciales

Los tokens son provistos por PASE al momento de la habilitación del acceso. Para solicitar acceso o reportar un token comprometido, contactar a administracion@paseaog.com.

Códigos de error

La API usa códigos HTTP estándar. Todos los errores devuelven un objeto JSON con status y message.

{
  "status":  "error",
  "message": "Descripción del error"
}

Cuotas y límites

POST /v1/certificates/status

Consulta el estado de formación para una lista de DNIs. Devuelve los cursos completados y un token de descarga para cada certificado disponible.

Request

Body

{
  "operator_id": "VISTA",
  "people": [
    { "dni": "2591137" },
    { "dni": "30456789" },
    { "dni": "99999999" }
  ]
}

Response 200 OK

{
  "status": "success",
  "operator_id": "VISTA",
  "total_requested": 3,
  "results": [
    {
      "dni": "2591137",
      "found": true,
      "courses": [
        {
          "course_id": 141,
          "course_name": "SGA Etiquetado Químico",
          "certificate_code": "mj285TvggX",
          "approved": true,
          "approved_at": "2026-05-12 08:29:13",
          "pdf_available": true,
          "download_token": "4428f2fc4d74516e06897f49ed41aacf..."
        },
        {
          "course_id": 136,
          "course_name": "Línea de Fuego",
          "certificate_code": "KGGSJwdWyy",
          "approved": true,
          "approved_at": "2024-09-04 11:22:47",
          "pdf_available": true,
          "download_token": "98318d8da2713ca6156a345079fc39..."
        }
      ]
    },
    {
      "dni": "30456789",
      "found": true,
      "courses": []
    },
    {
      "dni": "99999999",
      "found": false,
      "courses": []
    }
  ]
}

GET /v1/certificates/download/{token}

Descarga el PDF del certificado asociado al token obtenido en el endpoint de status. Devuelve el binario del PDF directamente.

Parámetros de URL

Request

GET /v1/certificates/download/4428f2fc4d74516e06897f49ed41aacf312595e0e3776bdd86b25d555556c4f5
Host: api.paselearning.com
Authorization: Bearer {tu_token}

Response 200 OK

El cuerpo de la respuesta es el binario del PDF. Guardarlo con extensión .pdf.

Errores posibles

Ejemplo con curl

# Descargar un certificado y guardarlo como PDF
curl -s \
  -H "Authorization: Bearer {tu_token}" \
  "https://api.paselearning.com/v1/certificates/download/{download_token}" \
  -o certificado_mj285TvggX.pdf

Objetos de respuesta

Objeto course

Ejemplos completos

Flujo completo: consulta y descarga

# Paso 1: Consultar estado de formación para 2 DNIs
curl -s -X POST \
  -H "Authorization: Bearer {tu_token}" \
  -H "Content-Type: application/json" \
  -d '{"operator_id":"VISTA","people":[{"dni":"2591137"},{"dni":"30456789"}]}' \
  "https://api.paselearning.com/v1/certificates/status"

# Paso 2: Descargar el PDF de cada certificado usando su download_token
curl -s \
  -H "Authorization: Bearer {tu_token}" \
  "https://api.paselearning.com/v1/certificates/download/{download_token}" \
  -o certificado.pdf

Batch de múltiples DNIs (Python)

import requests

BASE_URL = "https://api.paselearning.com"
TOKEN    = "{tu_token}"
HEADERS  = {"Authorization": f"Bearer {TOKEN}", "Content-Type": "application/json"}

# 1. Consultar estado
resp = requests.post(
    f"{BASE_URL}/v1/certificates/status",
    headers=HEADERS,
    json={"operator_id": "VISTA", "people": [{"dni": d} for d in ["2591137", "30456789"]]}
)
data = resp.json()

# 2. Descargar cada certificado
for person in data["results"]:
    for course in person.get("courses", []):
        if course["pdf_available"]:
            pdf = requests.get(
                f"{BASE_URL}/v1/certificates/download/{course['download_token']}",
                headers=HEADERS
            )
            filename = f"cert_{course['certificate_code']}.pdf"
            with open(filename, "wb") as f:
                f.write(pdf.content)
            print(f"✓ {person['dni']} — {course['course_name']} → {filename}")