Verify Sign-in Code

POST

api

sys

users

restore

verify

Verify Sign-in Code

curl --request POST \
  --url https://spaces.nexudus.com/api/sys/users/restore/verify \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Email": "<string>",
  "Code": "<string>"
}
'

import requests

url = "https://spaces.nexudus.com/api/sys/users/restore/verify"

payload = {
    "Email": "<string>",
    "Code": "<string>"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({Email: '<string>', Code: '<string>'})
};

fetch('https://spaces.nexudus.com/api/sys/users/restore/verify', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Token": "<string>"
}

Takes the six-digit code from the email sent by Send Verification Email (or by Send Proposal Sign-in Code) and answers a fresh access token: the token the email’s link would have carried back to the page as ?token=. Send it as Token with the sign-up (and with Check Sign-up Email): it proves the address, so the sign-up goes ahead instead of answering MUST_SIGN_IN, and it skips reCAPTCHA, whose answer was spent on the first attempt. A right code is spent: the token it came from, and the link in the same email, stop working. The token answered lasts 60 minutes, so the customer can finish the rest of the sign-up form with it. It is minted without the second factor, like every emailed token, so it cannot open a session on an account with two-factor authentication.

Authentication

No authentication required. Every wrong code is counted: after 5 for the same code that code is refused even when right, after 20 for the account within 24 hours every code is refused until the period has passed, and wrong codes count towards the failed sign-in limit of the network they come from.

Request Body

string

required

The address the code was sent to.

string

required

The six digits. Spaces and dashes are ignored.

Response

string

The proof of the address, for the sign-up’s Token.

Errors

Message	When
`INVALID_CODE`	The code is wrong or has expired, or no account has this address
`TOO_MANY_ATTEMPTS`	Too many wrong codes for this code, this account or this network. A new code (or a wait) is needed

Examples

POST /api/sys/users/restore/verify
Content-Type: application/json

{
  "Email": "[email protected]",
  "Code": "482913"
}

{
  "Token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

TypeScript Integration

import { verifySignInCode } from '@/views/checkout/useCheckoutData'
import { getSignInCodeErrorMessage } from '@/views/checkout/components/signInCodeErrors'

try {
  const token = await verifySignInCode(httpClient, '[email protected]', code)
  // send it as the signup's Token
} catch (ex) {
  throw new Error(getSignInCodeErrorMessage(t, ex))
}

Verify Sign-in Code

curl --request POST \
  --url https://spaces.nexudus.com/api/sys/users/restore/verify \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Email": "<string>",
  "Code": "<string>"
}
'

import requests

url = "https://spaces.nexudus.com/api/sys/users/restore/verify"

payload = {
    "Email": "<string>",
    "Code": "<string>"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({Email: '<string>', Code: '<string>'})
};

fetch('https://spaces.nexudus.com/api/sys/users/restore/verify', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Token": "<string>"
}

Getting Started

Authentication

System

Profile

Customers & Directory

Teams

Events

Perks

Courses

Articles

Plans

Onboarding

Products & Store

Proposals

Newsletter

Checkout & Sign Up

FAQs

Help Desk

Identity Checks

Resources

Bookings

Passport

Announcements

Check-ins

Deliveries

Files

Sensors

Visitors

Community

Forms

Settings

Billing & Payments

AI

Authentication

Request Body

Response

Errors

Examples

TypeScript Integration

​Verify Sign-in Code

​Authentication

​Request Body

​Response

​Errors

​Examples

​TypeScript Integration

Verify Sign-in Code

Authentication

Request Body

Response

Errors

Examples

TypeScript Integration