Validate ElectronJS login and create session

Summary

  • Source repository: jef-systems/jef-one-backend

  • Source SHA: 3273bbeddc16c50d6dbcbe4d5b15cc30bdcb89d4

  • Source run id: 28958211201

  • Module: One

  • Lambda function: jef-one-validate-electronjs-login-and-create-session

  • HTTP method: POST

  • Invocation mode: async

  • Package mode: no-package

  • API category: One Complex No Package Async POST APIs

  • API path: /jef-one-validate-electronjs-login-and-create-session

  • Endpoint URL: https://api.jefoffice.com/jef-one-validate-electronjs-login-and-create-session

  • Documentation scope: lambda-complex-no-packages

Async Confirmation Rule

This write API is documented as an async accepted request, not final write success. Use the corresponding GET API to confirm the final state.

Description

ElectronJS desktop durable auth login. Resolves domain/entity/application access, writes session parent plus session-payload child, then asynchronously verifies employee credentials.

Payload Example

{
  "entity_number": "1000",
  "application_name": "jef-one",
  "employee_number": "10000",
  "password": "pass1234"
}

Payload Schema

{
  "root": {
    "type": "M",
    "required": true,
    "attributes": {
      "session_id": {
        "type": "S",
        "required": false
      },
      "entity_number": {
        "type": "S",
        "required": true
      },
      "application_name": {
        "type": "S",
        "required": true
      },
      "employee_number": {
        "type": "S",
        "required": true
      },
      "password": {
        "type": "S",
        "required": true
      }
    }
  }
}

Response Schema

{
  "root": {
    "type": "M",
    "required": true,
    "attributes": {
      "is_accepted": {
        "type": "BOOL",
        "required": true
      },
      "is_valid": {
        "type": "BOOL",
        "required": true
      },
      "can_continue": {
        "type": "BOOL",
        "required": true
      },
      "session_saved": {
        "type": "BOOL",
        "required": true
      },
      "session_active": {
        "type": "BOOL",
        "required": true
      },
      "is_active": {
        "type": "BOOL",
        "required": true
      },
      "message": {
        "type": "S",
        "required": true
      },
      "operation": {
        "type": "S",
        "required": true
      },
      "status_code": {
        "type": "N",
        "required": true
      },
      "session_id": {
        "type": "S",
        "required": false
      },
      "session_payload_id": {
        "type": "S",
        "required": false
      },
      "domain_id": {
        "type": "S",
        "required": false
      },
      "main_parent_key_name": {
        "type": "S",
        "required": false
      },
      "main_parent_key_value": {
        "type": "S",
        "required": false
      },
      "entity_number": {
        "type": "S",
        "required": false
      },
      "application_name": {
        "type": "S",
        "required": false
      },
      "employee_number": {
        "type": "S",
        "required": false
      },
      "application_credential_id": {
        "type": "S",
        "required": false
      },
      "application_id": {
        "type": "S",
        "required": false
      },
      "entity_id": {
        "type": "S",
        "required": false
      },
      "employee_id": {
        "type": "S",
        "required": false
      },
      "entity_credential_id": {
        "type": "S",
        "required": false
      },
      "display_name": {
        "type": "S",
        "required": false
      },
      "status": {
        "type": "S",
        "required": false
      },
      "expires_at": {
        "type": "S",
        "required": false
      },
      "created": {
        "type": "S",
        "required": false
      },
      "updated": {
        "type": "S",
        "required": false
      },
      "verified_at": {
        "type": "S",
        "required": false
      },
      "failure_code": {
        "type": "S",
        "required": false
      },
      "failure_reason": {
        "type": "S",
        "required": false
      }
    }
  }
}

Request Payload

{
  "entity_number": "1000",
  "application_name": "jef-one",
  "employee_number": "10000",
  "password": "pass1234"
}

CMD curl

curl.exe -X POST "https://api.jefoffice.com/jef-one-validate-electronjs-login-and-create-session" -H "Content-Type: application/json" --data-raw '{}'

PowerShell curl

curl.exe -X POST "https://api.jefoffice.com/jef-one-validate-electronjs-login-and-create-session" -H "Content-Type: application/json" --data-raw '{}'