# Login into Flux

Login into Flux by submitting correct ZelID, login phrase and signature. Note that to get the signature of the signed message you would need to do the signing on Zelcore or your BTC wallet or your ETH wallet. If success status response is returned, we can use the supplied data(zelid, loginPhrase, signature) as zelauth header as part of api calls that require a user to be logged in. Additionally it is possible to listen for a response on websocket. ws://{Flux_IP}:16127/ws/id/{loginPhrase}. 

Endpoint: POST /id/verifylogin
Version: 6.6.1

## Request fields (text/plain):

  - `loginPhrase` (string)
    Login Phrase. Provided by GET /id/loginphrase.
    Example: "1574991374806spbcvsuwerl52tppx9dw5khuz8rew13mkq86gg8r2c"

  - `zelid` (string)
    ZelID or any P2PKH bitcoin address or ethereum address
    Example: "1CbErtneaX2QVyUfwU7JGB7VzvPgrgc3uC"

  - `signature` (string)
    Signature of signed loginPhrase with zelid.
    Example: "H+ZB3oSrsw6XkBxxlbwk33LEBJYvqtbMIm2kL9JzuoXMC6pSZd0lBHdnhJYzMTXv81zZQ7G/pkK1NvYN7cNF0GE="

## Response 200 fields (application/json):

  - `status` (string)
    status
    Enum: "success", "error"

  - `data` (object)

  - `data.message` (string)
    explanation of status

  - `data.zelid` (string)
    supplied ZelID or bitcoin P2PKH address or ethereum address

  - `data.loginPhrase` (string)
    valid and active loginPhrase

  - `data.signature` (string)
    signature of loginPhrase signed with zelid/btc/eth address

  - `data.privilege` (string)
    granted Flux privilege
    Enum: "user", "fluxteam", "admin"

## Response 400 fields (application/json):

  - `status` (string)
    Enum: "error"

  - `data` (object)

  - `data.name` (string)
    Example: "ValidationError"

  - `data.message` (string)
    Example: "Invalid input parameters"

  - `data.code` (string)
    Example: "VALIDATION_ERROR"

  - `data.details` (array)
    Detailed validation errors

  - `data.details.field` (string)
    Field name that failed validation

  - `data.details.message` (string)
    Validation error message

## Response 401 fields (application/json):

  - `status` (string)
    Enum: "error"

  - `data` (object)

  - `data.name` (string)
    Example: "UnauthorizedAccess"

  - `data.message` (string)
    Example: "Unauthorized. Invalid signature or insufficient privilege."

  - `data.code` (string)
    Example: "UNAUTHORIZED"

## Response 500 fields (application/json):

  - `status` (string)
    Enum: "error"

  - `data` (object)

  - `data.name` (string)
    Example: "InternalError"

  - `data.message` (string)
    Example: "Internal server error occurred"

  - `data.code` (string)
    Example: "INTERNAL_ERROR"