-Проверка по реестру МВД
-Кем выдан паспорт
DaDataPassport::standardization(string $id) Проверяет паспорт по справочнику недействительных паспортов МВД.
Основные кейсы:
Пример вызова
<?php
namespace App;
use MoveMoveIo\DaData\Facades\DaDataPassport;
/**
* Class DaData
* @package App\DaData
*/
class DaData
{
/**
* DaData passport
*
* @return void
*/
public function passportExample() : void
{
$dadata = DaDataPassport::standardization('4509 235857');
dd($dadata);
}
}
Параметры вызова
| Название | Тип | Optional | Default value | Описание |
|---|---|---|---|---|
id |
string |
false |
Текст запроса |
Пример ответа
array:1 [
0 => array:4 [
"source" => "4509 235857"
"series" => "45 09"
"number" => "235857"
"qc" => 0
]
]
Описание ответа
| Название | Длина | Описание |
|---|---|---|
source |
100 |
Исходная серия и номер одной строкой |
series |
20 |
Серия |
number |
20 |
Номер |
qc |
5 |
Код проверки. |
qc |
Нужна ручная проверка? | Описание |
|---|---|---|
| 0 | нет | Действующий паспорт |
| 2 | нет | Исходное значение пустое |
| 1 | да | Неправильный формат серии или номера |
| 100 | да | Недействительный паспорт |
Exceptions
При вызове методов, вы можете обрабатывать коды исключений и их сообщения
| Код | Описание |
|---|---|
400 |
Некорректный запрос |
401 |
В запросе отсутствует API-ключ или секретный ключ или в запросе указан несуществующий ключ |
403 |
Не подтверждена почта или недостаточно средств для обработки запроса, пополните баланс |
405 |
Запрос сделан с методом, отличным от POST |
429 |
Слишком много запросов в секунду или новых соединений в минуту |
5xx |
Произошла внутренняя ошибка сервиса |
Более детальную информацию вы можете получить из сообщения исключения.
Пример получения сообщения исключения
<?php
namespace App;
use MoveMoveIo\DaData\Facades\DaDataPassport;
/**
* Class DaData
* @package App\DaData
*/
class DaData
{
/**
* DaData passport
*
* @return void
*/
public function passportExample() : void
{
try {
$dadata = DaDataPassport::standardization('4509 235857');
dd($dadata);
} catch (\Exception $e) {
dd($e->getMessage());
}
}
}
DaDataPassport::fns(string $passport, int $count) Моментально заполняет организацию, выдавшую паспорт, по коду подразделения
Самое утомительное поле при вводе паспорта — «Кем выдан». Писать какое-нибудь «Отделом внутренних дел Медведевского района республики Марий Эл» муторно. Поэтому мы сделали подсказки по полю «Паспорт выдан...».
Пример вызова
<?php
namespace App;
use MoveMoveIo\DaData\Facades\DaDataPassport;
/**
* Class DaData
* @package App\DaData
*/
class DaData
{
/**
* DaData FNS
*
* @return void
*/
public function fnsExample() : void
{
$dadata = DaDataPassport::fms('772 053', 2);
dd($dadata);
}
}
Параметры вызова
| Название | Тип | Optional | Default value | Описание |
|---|---|---|---|---|
id |
string |
false |
Текст запроса | |
count |
int |
true |
10 | Количество результатов. Максимум 20 |
Пример ответа
array:1 [
"suggestions" => array:2 [
0 => array:3 [
"value" => "ОВД ЗЮЗИНО Г. МОСКВЫ"
"unrestricted_value" => "ОВД ЗЮЗИНО Г. МОСКВЫ"
"data" => array:4 [
"code" => "772-053"
"name" => "ОВД ЗЮЗИНО Г. МОСКВЫ"
"region_code" => "77"
"type" => "2"
]
]
1 => array:3 [
"value" => "ОВД ЗЮЗИНО Г. МОСКВЫ ПАСПОРТНЫЙ СТОЛ 1"
"unrestricted_value" => "ОВД ЗЮЗИНО Г. МОСКВЫ ПАСПОРТНЫЙ СТОЛ 1"
"data" => array:4 [
"code" => "772-053"
"name" => "ОВД ЗЮЗИНО Г. МОСКВЫ ПАСПОРТНЫЙ СТОЛ 1"
"region_code" => "77"
"type" => "2"
]
]
]
]
Описание ответа
| Название | Описание |
|---|---|
value |
Значение одной строкой (как показывается в списке подсказок) |
unrestricted_value |
== value |
data['code'] |
Код подразделения |
data['name'] |
Название подразделения в творительном падеже («кем выдан?») |
data['region_code'] |
Код региона (2 цифры) |
data['type'] |
Вид подразделения (1 цифра). 0 — подразделение ФМС, 1 — ГУВД или МВД региона, 2 — УВД или ОВД района или города, 3 — отделение полиции |
Exceptions
При вызове методов, вы можете обрабатывать коды исключений и их сообщения
| Код | Описание |
|---|---|
400 |
Некорректный запрос |
401 |
В запросе отсутствует API-ключ или секретный ключ или в запросе указан несуществующий ключ |
403 |
Не подтверждена почта или недостаточно средств для обработки запроса, пополните баланс |
405 |
Запрос сделан с методом, отличным от POST |
429 |
Слишком много запросов в секунду или новых соединений в минуту |
5xx |
Произошла внутренняя ошибка сервиса |
Более детальную информацию вы можете получить из сообщения исключения.
Пример получения сообщения исключения
<?php
namespace App;
use MoveMoveIo\DaData\Facades\DaDataPassport;
/**
* Class DaData
* @package App\DaData
*/
class DaData
{
/**
* DaData FNS
*
* @return void
*/
public function fnsExample() : void
{
try {
$dadata = DaDataPassport::fms('772 053', 2);
dd($dadata);
} catch (\Exception $e) {
dd($e->getMessage());
}
}
}