Nuevas Apis para Integracion Clientes
    • Portal developer integraciones Trabajando.com
    • Catálogos
    • Raíz
      • JobPosting
        • Gestionar vacantes de empleo
        • Obtiene una oferta JobPosting
        • Crea una oferta JobPosting
        • Actualiza una oferta JobPosting
        • Actualiza estado de una oferta JobPosting
        • Obtiene listado de ofertas JobPosting para un dominio
      • Person
        • Obtiene un candidato Person
      • Apply
        • Obtiene postulaciones por oferta
    • Schemas
      • ContactPointDTO
      • Answer
      • ApplicationContact
      • DefinedTerm
      • ApplicationQuestion
      • EducationalOccupationalCredential
      • HiringOrganization
      • GeoCoordinates
      • Identifier
      • JobPostingRequest
      • MonetaryAmount
      • OfertaResponse
      • OccupationalExperienceRequirements
      • Place
      • PostalAddress
      • Usuario
      • PotentialAction
      • PropertyValue
      • QuantitativeValue
      • Question
      • JobPostingStatusRequest
      • AtsErrorDTO
      • JobPostingResponse
      • UsuarioUpdateRequest
      • Certification
      • IntegracionExternaUpdateRequest
      • Country
      • Credencial
      • DigitalDocument
      • UsuarioRequest
      • EducationalOrganization
      • ConsumerRequest
      • Evaluation
      • IntegracionExternaRequest
      • Language
      • Occupation
      • Organization
      • PersonResponse
      • Skill
      • SocialMedia
      • JobPostingItem
      • JobPostingListResponse
      • ListItem
      • UsuarioResponse
      • IntegracionExternaResponse

    Portal developer integraciones Trabajando.com

    🚀 Bienvenido a la API de Trabajando.com#

    Bienvenido a la documentación oficial para desarrolladores. Nuestra API te permite automatizar el flujo de datos entre tu plataforma y nuestros servicios de manera segura y escalable.

    🏗️ 1. Flujo de Alto Nivel#

    El siguiente diagrama ilustra cómo interactúa tu sistema con nuestra API para el intercambio de información. Comprender este flujo es esencial antes de iniciar la codificación.

    image.png
    Figura 1: Interacción entre el Cliente (ATS) y los servicios de Trabajando.com.#

    ✅ 2. Requisitos de Uso#

    Para garantizar la seguridad y el correcto funcionamiento, asegúrate de cumplir con los siguientes requisitos:

    Obtención de Credenciales#

    La API Key para el entorno productivo debe ser generada directamente por el cliente:
    1.
    Inicia sesión en el ATS de Trabajando.com.
    2.
    Dirígete al módulo Configuración > Integraciones.
    image.png
    3. Seleccionar la casilla integraciones-->Generar Key
    image.png
    4.
    Seleccionar al proveedor que usará la integración
    image.png
    5.
    Genera y copia tu clave de acceso.
    image.png
    ⚠️ Precaución
    La API Key es confidencial. Debe ser entregada al proveedor de servicios únicamente, si se sospecha que ha sido comprometida, se recomienda generar una nueva API Key-

    Gestión de Permisos#

    Por defecto, la API Key generada tendrá permisos habilitados para todos los endpoints disponibles en nuestra documentación, simplificando la configuración inicial.

    🔐 3. Guía de Autenticación#

    Nuestra API utiliza autenticación basada en encabezados (Headers). Debes incluir tu llave en cada petición HTTP.
    HeaderValor
    x-api-keyTU_API_KEY_PROVISTA
    Content-Typeapplication/json
    Ejemplo de petición (cURL):
    ⚠️ Atención
    En entornos de desarrollo no existen credenciales diferenciadas por cliente, se debe utilizar la misma que está disponible en la sección de pruebas
    image.png

    🌐 4. Entornos (Environments)#

    Ofrecemos un entorno de pruebas dedicado para que puedas validar tu desarrollo antes de pasar a producción de manera segura.
    CaracterísticaAmbiente de Pruebas (Sandbox)Ambiente de Producción
    FinalidadSimulación, aprendizaje y testing.Tráfico real y datos vivos.
    AislamientoEntorno compartido (sin separación por cliente).Datos privados por cliente.
    DisponibilidadLunes a Viernes 08:30 - 19:0024/7
    URLapidev.demotbj.comapi.trabajando.com

    💡 Nota importante sobre el entorno de pruebas#

    [!IMPORTANT]
    El ambiente de pruebas es de uso exclusivo para desarrollo y no cuenta con soporte de alta disponibilidad (24/7). Por favor, programa tus actividades de integración dentro del horario laboral establecido para evitar interrupciones en el servicio.

    🆘 Soporte y Ayuda#

    Si tienes dudas sobre endpoints específicos o necesitas asistencia técnica durante tu proceso de integración, puedes utilizar los siguientes canales:
    Soporte técnico: soporte.integraciones@trabajando.com
    Estado del servicio: status.trabajando.com
    Modificado en 2026-07-29 19:53:47
    Siguiente
    Catálogos
    Built with