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.
This endpoint is used to send to person’s another authentication method after Update person request. The sms is sended by default to auth_method which has field is_primary = True.
At the response of Update person request and Get by ID in the block urgent has the array of all person’s methods of authentication. There is the alias of the methods. In request of endpoint Resend auth method transfer alias and the type of authentication to send an SMS to it.

Specification

Apiary: Resend Authorization method on 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

...

1. • .

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

...

Generate upload URL

...

1. .

...

• Generate URL's with type person.{$.person.documents.[:].type} ( or third_person.documents[:].type)

And make links that were generated on the update are not valid

Processing

Generate verification code

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

At this stage, the person receives an SMS message to confirm creating or updating a person's data.

cURL example

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

...

Make code that was generated on the creating or updating is not valid.

Change

...

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