forked from LibreMV/GridFlow
61 lines
1.4 KiB
Markdown
61 lines
1.4 KiB
Markdown
## Password reset
|
|
|
|
|
|
## Request for OTP
|
|
#### You will need to provide existing account phone number in this request
|
|
```bash
|
|
curl --request POST \
|
|
--url https://api.fenaka.mv/auth/password-reset/request \
|
|
--header 'authorization: Bearer TOKEN' \
|
|
--header 'content-type: application/json' \
|
|
--data '{"mobile":"PHONE_NUMBER"}'
|
|
```
|
|
- This should send a 1 digit OTP to phone number you requested, but at the time of writing this document fenaka SMS seems to be broken
|
|
|
|
You will also get a "Set-Cookie" in reponse header, which will be needed for submitting OTP, store this header somewhere for later user
|
|
```
|
|
Set-Cookie: connect.sid=; HttpOnly; Path=/
|
|
```
|
|
(you only need the part before the first ";")
|
|
|
|
## HTTP 200
|
|
- You will just the requested phone number in json
|
|
```json
|
|
{
|
|
"mobile": ""
|
|
}
|
|
```
|
|
|
|
## HTTP 404
|
|
- You will get this reponse if there is no registered account
|
|
```json
|
|
{
|
|
"error": "not-found"
|
|
}
|
|
```
|
|
## Submit OTP
|
|
|
|
I CANNOT TEST THIS AT THE TIME OF WRITING THIS DOCUMENT BECAUSE SMS IS NOT WORKING \
|
|
but here is how to:
|
|
```bash
|
|
curl --request POST \
|
|
--url https://api.fenaka.mv/auth/verify-otp/password-reset \
|
|
--header 'authorization: Bearer TOKEN' \
|
|
--header 'content-type: application/json' \
|
|
--data '{"otp":"1111"}'
|
|
```
|
|
|
|
## HTTP 422
|
|
```json
|
|
{
|
|
"errors": [
|
|
{
|
|
"value": "1111",
|
|
"msg": "invalid otp",
|
|
"param": "otp",
|
|
"location": "body"
|
|
}
|
|
]
|
|
}
|
|
```
|