Versions Compared

Key

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

OTP Verification

...

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

...

Expand
titleHeader example


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


Validation data request

API paragraph not found

...

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
  }
}


...

API paragraph not found

HTTP status codes

HTTP status code

Message

What caused the error

200

Response

 


Backward compatibility

API paragraph not found