Purpose

This method is used when you need to re-send SMS to a person who approve creating or updating data about himself.

This method can be used to send to the same number that was sent after the Create/Update person request.

Specification

Input parameters

Request structure

See on Apiary

Authorize

1. Verify the validity of access token

   • Check user scope person_request:write in order to perform this action.

Headers

• Content-Type:application/json

• Authorization:Bearer {{access_token}}

• api-key:{{secret}}

Request data validation

1. Validate auth method. Person must has auth_method.type = OTP or THIRD_PERSON( where third_person.auth_method.type = OTP)

2. Check that person_request.status = NEW.

Processing

Generate verification code

Invoke Initialize OTP to generate one time password and send it to client number.

cURL example

curl -X POST \
  http://localhost:4000/verifications \
  -H 'content-type: application/json' \
  -d '{
  "phone_number": "+380958697084"
}'

Response structure

Example:

{
  "meta": {
    "code": 200,
    "url": "https://example.com/resource",
    "type": "object",
    "request_id": "req-adasdoijasdojsda"
  },
  "data": {
    "id": "7d23bebb-1cf3-4221-bf21-18aada444756",
    "status": "NEW",
    "code_expired_at": "2017-07-10T12:20:16.300597Z",
    "active": true
  }
}

HTTP status codes