masstack

V1
API Overview Resources Schemas

OTP

One-Time Password

Parameters

Name In Type Required Description
username path string true a username of Grupo Mamovil
org path string true a orgID of Grupo Mamovil
body body GenerateOTPRequest false Language of communication

Request body - instance of GenerateOTPRequest

1
2
3
4

{
  "language": "es",
  "hint": "user@masmovil.com"
}
Name Type Required Description
language string false Customer’s preferred language for communications
hint string false Customer’s preferred channel to send otp

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


curl -X POST https://credentials.masstack.com/v1/orgs/{org}/credentials/{username}/otp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}" \
 --data-raw "{
  'language': 'es',
  'hint': 'user@masmovil.com'
}"

Responses

Code Meaning Description Schema
201 Created OTP Time to live GenerateOTPResponse
400 Bad Request Error response ErrorDto
401 Unauthorized Error response ErrorDto
403 Forbidden Error response ErrorDto
404 Not Found Error response ErrorDto
409 Conflict Error response ErrorDto
500 Internal Server Error Error response ErrorDto

Parameters

Name In Type Required Description
username path string true a username of Grupo Mamovil
org path string true a orgID of Grupo Mamovil
body body ValidateOTPRequest true Validate OTP

Request body - instance of ValidateOTPRequest

1
2
3

{
  "code": "280597"
}
Name Type Required Description
code string false OTP to validate

Request example

1
2
3
4
5
6
7
8
9


curl -X PUT https://credentials.masstack.com/v1/orgs/{org}/credentials/{username}/otp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}" \
 --data-raw "{
  'code': '280597'
}"

Responses

Code Meaning Description Schema
204 No Content OK None
400 Bad Request Error response ErrorDto
401 Unauthorized Error response ErrorDto
403 Forbidden Error response ErrorDto
404 Not Found Error response ErrorDto
409 Conflict Error response ErrorDto
500 Internal Server Error Error response ErrorDto

Endpoints

Credentials

    Flows

      Tokens

        Magic links

          OTP

            TOTP

              Devices