Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

Сценарій поведінки

Користувач вводить номер телефону в систему.

...

OTP Verification

Purpose

This method is designed to verify that provided in the declaration request phone number is valid and is in service. Initialization phase

Specification

Link

eHealth MIS API · Apiary

Resource

/api/verifications

Scope

API paragraph not found

Components

SMS

Using Dictionaries

API paragraph not found

Using Microservices

API paragraph not found

Protocol type

REST

Request type

POST

Sync/Async

Sync

Public/Private/Internal

Public

Logic

The user enters the phone number into the system.

As a result, an SMS is sent to the entered number with OTP code and the system returns the following response to the request:

id = хххх
status = NEW
code_expired_at = строк придатності коду
аctive= true

Generate verification code

  1. Generate verification code using basic random (default) function or time-based algorithm

    • Verification code format - digits only ^[1-9][0-9]*$

    • Verification code length - configuration parameter (default = 4)

    • Verification code expiration period - configuration parameter (default = 15 min)

    • Set expiration period using configuration parameter

Deactivate active verification code

  1. Search active verification code(s) for this phone number

    • If found - change status to INACTIVE

Save verification code

  1. Save generated verification code to DB

Input parameters

Attributes

Attribute

Values

Type

Description

Example

phone_number


String

Required

+380508887700

Filters

None

Request structure

See on Apiary

Example

Expand
titleRequest example


Code Block
{
  "phone_number": "+380508887700"
}


Authorize

Request to process the request using a token in the headers

Headers

Example

Expand
titleHeader example


Code Block
Content-Type: application/json
Authorization: Bearer {token}
api-key: {secret}


Validation data request

API paragraph not found

Processing

API paragraph not found

Response structure

See on Apiary

Example:

Expand
titleResponse example


Code Block
{
  "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
  }
}


Post-processing processes

API paragraph not found

HTTP status codes

HTTP status code

Message

What caused the error

200

Response


Backward compatibility

API paragraph not found