codeauth-sdk 1.1.0

Official Python SDK for CodeAuth

CodeAuth Python SDK

Offical CodeAuth SDK. For more info, check the docs on our official website.

Installation

This package is available on PyPI:

pip install --upgrade codeauth-sdk

Basic Usage

Initialize CodeAuth SDK

from codeauth_sdk import (CodeAuth)
CodeAuth.Initialize("<your project API endpoint>", "<your project ID>")

Signin / Email

Begins the sign in or register flow by sending the user a one time code via email.

result = CodeAuth.SignInEmail("<user email>")
match result.error
{
	case "bad_json": print("bad_json")
	case "project_not_found": print("project_not_found")
	case "bad_ip_address": print("bad_ip_address")
	case "rate_limit_reached": print("rate_limit_reached")
	case "bad_email": print("bad_email")
	case "code_request_interval_reached": print("code_request_interval_reached")
	case "code_hourly_limit_reached": print("code_hourly_limit_reached")
	case "email_provider_error": print("email_provider_error")
	case "internal_error": print("internal_error")
	case "connection_error": print("connection_error") #sdk failed to connect to api server
}

Signin / Email Verify

Checks if the one time code matches in order to create a session token.

result = CodeAuth.SignInEmailVerify("<user email>", "<one time code>")
match result.error
{
	case "bad_json": print("bad_json")
	case "project_not_found": print("project_not_found")
	case "bad_ip_address": print("bad_ip_address")
	case "rate_limit_reached": print("rate_limit_reached")
	case "bad_email": print("bad_email")
	case "bad_code": print("bad_code")
	case "internal_error": print("internal_error")
	case "connection_error": print("connection_error") #sdk failed to connect to api server
}
print(result.session_token)
print(result.email)
print(result.expiration)
print(result.refresh_left)

Signin / Social

Begins the sign in or register flow by allowing users to sign in through a social OAuth2 link.

result = CodeAuth.SignInSocial("<social_type>")
match result.error
{
	case "bad_json": print("bad_json")
	case "project_not_found": print("project_not_found")
	case "bad_ip_address": print("bad_ip_address")
	case "rate_limit_reached": print("rate_limit_reached")
	case "bad_social_type": print("bad_social_type")
	case "internal_error": print("internal_error")
	case "connection_error": print("connection_error") #sdk failed to connect to api server
}
print(result.signin_url)

Signin / Social Verify

This is the next step after the user signs in with their social account. This request checks the authorization code given by the social media company in order to create a session token.

result = CodeAuth.SignInSocialVerify("<social type>", "<authorization code>")
match result.error
{
	case "bad_json": print("bad_json")
	case "project_not_found": print("project_not_found")
	case "bad_ip_address": print("bad_ip_address")
	case "rate_limit_reached": print("rate_limit_reached")
	case "bad_social_type": print("bad_social_type")
	case "bad_authorization_code": print("bad_authorization_code")
	case "internal_error": print("internal_error")
	case "connection_error": print("connection_error") #sdk failed to connect to api server
}
print(result.session_token)
print(result.email)
print(result.expiration)
print(result.refresh_left)

Session / Info

Gets the information associated with a session token.

result = CodeAuth.SessionInfo("<session_token>")
match result.error
{
	case "bad_json": print("bad_json")
	case "project_not_found": print("project_not_found")
	case "bad_ip_address": print("bad_ip_address")
	case "rate_limit_reached": print("rate_limit_reached")
	case "bad_session_token": print("bad_session_token")
	case "internal_error": print("internal_error")
	case "connection_error": print("connection_error") #sdk failed to connect to api server
}
print(result.email)
print(result.expiration)
print(result.refresh_left)

Session / Refresh

Create a new session token using existing session token.

result = CodeAuth.SessionRefresh("<session_token>")
match result.error
{
	case "bad_json": print("bad_json")
	case "project_not_found": print("project_not_found")
	case "bad_ip_address": print("bad_ip_address")
	case "rate_limit_reached": print("rate_limit_reached")
	case "bad_session_token": print("bad_session_token")
	case "out_of_refresh": print("out_of_refresh")
	case "internal_error": print("internal_error")
	case "connection_error": print("connection_error") #sdk failed to connect to api server
}
print(result.session_token)
print(result.email)
print(result.expiration)
print(result.refresh_left)

Session / Invalidate

Invalidate a session token. By doing so, the session token can no longer be used for any api call.

var result = CodeAuth.SessionInvalidate("<session_token>", "<invalidate_type>")
match result.error
{
	case "bad_json": print("bad_json")
	case "project_not_found": print("project_not_found")
	case "bad_ip_address": print("bad_ip_address")
	case "rate_limit_reached": print("rate_limit_reached")
	case "bad_session_token": print("bad_session_token")
	case "bad_invalidate_type": print("bad_invalidate_type")
	case "internal_error": print("internal_error")
	case "connection_error": print("connection_error") #sdk failed to connect to api server 
}