curl --request POST \
--url https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "sandbox@moonkey.fun",
"expires_in": 60,
"login_redirect_url": "http://localhost:8081/authenticate",
"registration_redirect_url": "http://localhost:8081/authenticate"
}
'import requests
url = "https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create"
payload = {
"email": "sandbox@moonkey.fun",
"expires_in": 60,
"login_redirect_url": "http://localhost:8081/authenticate",
"registration_redirect_url": "http://localhost:8081/authenticate"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
email: 'sandbox@moonkey.fun',
expires_in: 60,
login_redirect_url: 'http://localhost:8081/authenticate',
registration_redirect_url: 'http://localhost:8081/authenticate'
})
};
fetch('https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'email' => 'sandbox@moonkey.fun',
'expires_in' => 60,
'login_redirect_url' => 'http://localhost:8081/authenticate',
'registration_redirect_url' => 'http://localhost:8081/authenticate'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create"
payload := strings.NewReader("{\n \"email\": \"sandbox@moonkey.fun\",\n \"expires_in\": 60,\n \"login_redirect_url\": \"http://localhost:8081/authenticate\",\n \"registration_redirect_url\": \"http://localhost:8081/authenticate\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"sandbox@moonkey.fun\",\n \"expires_in\": 60,\n \"login_redirect_url\": \"http://localhost:8081/authenticate\",\n \"registration_redirect_url\": \"http://localhost:8081/authenticate\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"sandbox@moonkey.fun\",\n \"expires_in\": 60,\n \"login_redirect_url\": \"http://localhost:8081/authenticate\",\n \"registration_redirect_url\": \"http://localhost:8081/authenticate\"\n}"
response = http.request(request)
puts response.read_body{
"user_id": "user_24wFP9pDa9YiMJLun94iKykoZs2",
"status": "active",
"user_created": false,
"updated_at": 1630989225,
"created_at": 1630989225,
"email_id": "email_24oXBL3PufzHkH1Jzyjc2EXYeo7"
}Login or Create User by Magic Link
Create an email Magic Link to the provided email for login verification. If no user account exists, a new user will be created and Magic Link sent.
Returns
A successful response returns an object with user_id, user_created indicating if the user has been newly created, and email_id properties.
curl --request POST \
--url https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "sandbox@moonkey.fun",
"expires_in": 60,
"login_redirect_url": "http://localhost:8081/authenticate",
"registration_redirect_url": "http://localhost:8081/authenticate"
}
'import requests
url = "https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create"
payload = {
"email": "sandbox@moonkey.fun",
"expires_in": 60,
"login_redirect_url": "http://localhost:8081/authenticate",
"registration_redirect_url": "http://localhost:8081/authenticate"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
email: 'sandbox@moonkey.fun',
expires_in: 60,
login_redirect_url: 'http://localhost:8081/authenticate',
registration_redirect_url: 'http://localhost:8081/authenticate'
})
};
fetch('https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'email' => 'sandbox@moonkey.fun',
'expires_in' => 60,
'login_redirect_url' => 'http://localhost:8081/authenticate',
'registration_redirect_url' => 'http://localhost:8081/authenticate'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create"
payload := strings.NewReader("{\n \"email\": \"sandbox@moonkey.fun\",\n \"expires_in\": 60,\n \"login_redirect_url\": \"http://localhost:8081/authenticate\",\n \"registration_redirect_url\": \"http://localhost:8081/authenticate\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"sandbox@moonkey.fun\",\n \"expires_in\": 60,\n \"login_redirect_url\": \"http://localhost:8081/authenticate\",\n \"registration_redirect_url\": \"http://localhost:8081/authenticate\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.moonkey.fun/v1/auth/magic_links/email/login_or_create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"sandbox@moonkey.fun\",\n \"expires_in\": 60,\n \"login_redirect_url\": \"http://localhost:8081/authenticate\",\n \"registration_redirect_url\": \"http://localhost:8081/authenticate\"\n}"
response = http.request(request)
puts response.read_body{
"user_id": "user_24wFP9pDa9YiMJLun94iKykoZs2",
"status": "active",
"user_created": false,
"updated_at": 1630989225,
"created_at": 1630989225,
"email_id": "email_24oXBL3PufzHkH1Jzyjc2EXYeo7"
}Authorizations
Auth Platform API includes all the Auth related features. All Users, Phone Numbers, Emails, and OTPs are associated with an App as the container.
Endpoints only accept App's Secret API keys other than certain endpoints that are used client side or via SDK that accept the public_token.
Authentication using App Api Key
Header:
Authorization: Bearer {api_key}
Authenticated Request
curl \
-X GET https://api.moonkey.fun/v1/auth/users/user_24wFP9pDa9YiMJLun94iKykoZs2 \
-H "Authorization: Bearer sk_test_pRqweh3wvWmJAAVYv7Z0T5iPLzFM4ql0muoyQcjOxGeN3p1r"
Body
Required Email that uniquely identifies the user.
1The base url we will use to construct the final login magic link and send to the user via email if this is a login (existing user). If the redirect_url is https://moonkey.fun/authenticate, final url user sees in email will be https://moonkey.fun/authenticate?token=autogeneratedmagictoken. We will redirect to your app in this url and your app should handle and parse the token parameter and allow the user log in. If no url is sent in, we will use the default redirect url set in the Console and if no default redirect url is available, an error will be returned.
The base url we will use to construct the final login magic link and send to the user via email if this is a registration (new user). If the redirect_url is https://moonkey.fun/authenticate, final url user sees in email will be https://moonkey.fun/authenticate?token=autogeneratedmagictoken. We will redirect to your app in this url and your app should handle and parse the token parameter and register the user. If no url is sent in, we will use the default redirect url set in the Console and if no default redirect url is available, an error will be returned.
Expiration time of the magic link in minutes for login (when an existing user is found) Must be between 5 to 10080 minutes (7 days), defaults to 60 minutes.
Expiration time of the magic link in minutes for registration (when a new user is created). Must be between 5 to 10080 minutes (7 days), defaults to 60 minutes.
Determines if verification for the authentication method (email, phone_number) is required before marking the user as active.
Device fingerprinting metadata for fraud detection during verification step. This is useful to ensure that the user who originated the request matches the user that verifies the token. Verification requirements can be enabled in the Verify Token step by matching fields in the device_fingerprint such as IP, User Agent or the combination of them (more fraud detection features coming soon!)
Show child attributes
Show child attributes