Descripción

Integración completa con APIs REST para sincronización bidireccional. Incluye migración inicial por lotes y sincronización continua automática.

¿Cómo funciona el Upsert?

Cuando envías datos a través de nuestros endpoints, el sistema determina automáticamente si debe crear un nuevo registro o actualizar uno existente. Este comportamiento se llama Upsert (Update + Insert).

Requisitos Técnicos

Autenticación y seguridad

Todas las peticiones requieren un token de autenticación enviado en el header:

x-api-key: {api_key}

Si una solicitud proviene de una IP no autorizada, la API responderá con un error 403 – Forbidden, incluso si el API Key es válido.

Endpoints Disponibles

Estudiantes

Envía los datos de un estudiante para crearlo o actualizarlo. El sistema identifica al estudiante por su dni (documento de identidad). Si el código no existe, se crea un nuevo perfil. Si ya existe, se actualizan los campos proporcionados.

{
    "status": 201,
    "success": true,
    "message": "Estudiante creado exitosamente",
    "result": "created",
    "data": {
        "university_id": "UTest"
    }
}

Referencia de campos

Empleadores

Envía los datos de una empresa para crearla o actualizarla. El sistema identifica la empresa por su cuit (número de identificación tributaria). Si no existe, se crea la empresa. Si ya existe, se actualizan los campos proporcionados.

{
    "status": 201,
    "success": true,
    "message": "Compañía creada exitosamente",
    "result": "created",
    "data": {
        "cuit": "20209999980"
    }
}

Referencia de campos

Manejo de Errores

La API responde con códigos de estado HTTP claros y mensajes descriptivos ante cualquier error. Es fundamental que las integraciones manejen adecuadamente estos errores, validando los datos enviados y gestionando respuestas como se muestra a continuación.

{
    "status": 400,
    "label": "Bad Request",
    "description": "Datos inválidos",
    "body": {
        "error": "Bad Request",
        "message": "El cuerpo de la petición contiene datos inválidos o mal formateados.",
        "details": [
            {
                ...
            }
        ]
    }
}

Rate Limiting

Fases de Implementación

Ventajas