Auth Actions

https://api.app.wnology.io/auth

Below are the various requests that can be performed against the Auth resource, as well as the expected parameters and the potential responses.

Authenticate Device

Authenticates a device using the provided credentials.

Method And Url

POST https://api.app.wnology.io/auth/device

Authentication

No authentication is required for this endpoint.

Request Body

The body of the request should be serialized JSON that validates against the Device Credentials schema. For example, the following would be a valid body for this request:

{
  "deviceId": "575ecf887ae143cd83dc4aa2",
  "key": "this_would_be_the_key",
  "secret": "this_would_be_the_secret"
}

Curl Example

curl -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -X POST \
    -d '{"deviceId":"575ecf887ae143cd83dc4aa2","key":"this_would_be_the_key","secret":"this_would_be_the_secret"}' \
    https://api.app.wnology.io/auth/device

Successful Responses

Error Responses

Authenticate User

Authenticates a user using the provided credentials.

Method And Url

POST https://api.app.wnology.io/auth/user

Authentication

No authentication is required for this endpoint.

Request Body

The body of the request should be serialized JSON that validates against the User Credentials schema. For example, the following would be a valid body for this request:

{
  "email": "example@weg.net",
  "password": "this is the password"
}

Curl Example

curl -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -X POST \
    -d '{"email":"example@weg.net","password":"this is the password"}' \
    https://api.app.wnology.io/auth/user

Successful Responses

Error Responses

Authenticate User Github

Authenticates a user via GitHub OAuth.

Method And Url

POST https://api.app.wnology.io/auth/user/github

Authentication

No authentication is required for this endpoint.

Request Body

The body of the request should be serialized JSON that validates against the Github Login schema. For example, the following would be a valid body for this request:

{
  "accessToken": "the github access token"
}

Curl Example

curl -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -X POST \
    -d '{"accessToken":"the github access token"}' \
    https://api.app.wnology.io/auth/user/github

Successful Responses

Error Responses

Authenticate User Saml

Authenticates a user via a SAML response.

Method And Url

POST https://api.app.wnology.io/auth/user/saml

Authentication

No authentication is required for this endpoint.

Request Body

The body of the request should be serialized JSON that validates against the SAML Response schema. For example, the following would be a valid body for this request:

{
  "SAMLResponse": "PHNhbWxwOlJlc3BvbnNlIHhtbG5zOnNhbWxwPSJ1cm46b2FzaXM6bmFtZXM6dGM6U0FNTDoy...",
  "SAMLDomain": "app.wnology.io"
}

Curl Example

curl -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -X POST \
    -d '{"SAMLResponse":"PHNhbWxwOlJlc3BvbnNlIHhtbG5zOnNhbWxwPSJ1cm46b2FzaXM6bmFtZXM6dGM6U0FNTDoy...","SAMLDomain":"app.wnology.io"}' \
    https://api.app.wnology.io/auth/user/saml

Successful Responses

Error Responses

Sso Domain

Checks email domain for SSO configuration.

Method And Url

GET https://api.app.wnology.io/auth/ssoDomain

Authentication

No authentication is required for this endpoint.

Request Query Parameters

Curl Example

curl -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -X GET \
    https://api.app.wnology.io/auth/ssoDomain?email=example%40example.com

Successful Responses

Error Responses