TOTP – Developers

Generate an TOTP for this username

POST /orgs/{org}/credentials/{username}/totp

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}/totp \
  -H "Content-Type: application/json" \
  -H "Accept: image/png" \
  -H "Authorization: Bearer {access-token}" \
 --data-raw "{
  'language': 'es',
  'hint': 'user@masmovil.com'
}" 

Responses

Code	Meaning	Description	Schema
201	Created	TOTP	string
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

Retrieve QR code

Retrieve QR code with TOTP for this username

GET /orgs/{org}/credentials/{username}/totp

Parameters

Name	In	Type	Required	Description
username	path	string	true	a username of Grupo Mamovil
org	path	string	true	a orgID of Grupo Mamovil

Request example

1
2
3
4
5



curl -X GET https://credentials.masstack.com/v1/orgs/{org}/credentials/{username}/totp \
  -H "Accept: image/png" \
  -H "Authorization: Bearer {access-token}"

Responses

Code	Meaning	Description	Schema
201	Created	TOTP	string
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

Validate the TOTP

Validate an TOTP for this username

PUT /orgs/{org}/credentials/{username}/totp

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 TOTP

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}/totp \
  -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

Generate a passcode for the username

POST /orgs/{org}/credentials/{username}/totp/passcode

Parameters

Name	In	Type	Required	Description
username	path	string	true	a username of Grupo Mamovil
org	path	string	true	a orgID of Grupo Mamovil

Request example

1
2
3
4
5



curl -X POST https://credentials.masstack.com/v1/orgs/{org}/credentials/{username}/totp/passcode \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {access-token}"

Responses

Code	Meaning	Description	Schema
201	Created	User passcode	GeneratePasscodeResponse
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