README

SmartForm.cz API 集成，受 Contributte/GoSms 启发，为 Nette 框架提供

内容

• 需求
• 安装 - 注册扩展
• 使用

需求

在 smartform.cz 上创建账户，并从 https://admin.smartform.cz/wsUser/wsListYear 复制 clientId 和密码。

安装

extensions:
	smartForm: Awaitcz\SmartForm\DI\SmartFormExtension


smartForm:
	clientId: R3sZyjLPLP
	token: qLa1vcNn
	testMode: false # Optional, default false

使用

现在我们为您准备了三个客户端：AddressClient、CompanyClient 和 EmailClient。

所有方法在响应状态不是 200 时都会抛出带有错误信息和代码的 ClientException 异常；

AddressClient

• whisper() - Whisper address
• validate() - Validate address

CompanyClient

• whisper() - Whisper company
• validate() - Validate company

EmailClient

• validate() - Validate email

<?php

namespace App;

use Awaitcz\SmartForm\Client\AddressClient;
use Awaitcz\SmartForm\Client\CompanyClient;
use Awaitcz\SmartForm\Client\EmailClient;
use Awaitcz\SmartForm\Entity\Address\Validate\ValidateAddress;
use Awaitcz\SmartForm\Entity\Address\Whisper\Query\WhisperAddressByMunicipalityAndDistrict;
use Awaitcz\SmartForm\Entity\Address\Whisper\Query\WhisperAddressByStreetAndNumberMunicipalityPostCode;
use Awaitcz\SmartForm\Entity\Address\Whisper\Query\WhisperAddressByStreetNumberMunicipalityPostCode;
use Awaitcz\SmartForm\Entity\Address\Whisper\Query\WhisperAddressByWholeAddress;
use Awaitcz\SmartForm\Entity\Address\Whisper\WhisperAddress;
use Awaitcz\SmartForm\Entity\Company\Validate\ValidateCompany;
use Awaitcz\SmartForm\Entity\Company\Whisper\Query\WhisperCompanyByNameQuery;
use Awaitcz\SmartForm\Entity\Company\Whisper\WhisperCompany;
use Awaitcz\SmartForm\Entity\Country;
use Awaitcz\SmartForm\Entity\Email\Validate\ValidateEmail;
use Awaitcz\SmartForm\Exception\ClientException;


final class ExampleService
{

	public function __construct(
		private readonly AddressClient $addressClient,
		private readonly CompanyClient $companyClient,
		private readonly EmailClient $emailClient,
	)
	{
	}

	public function tryWhisperAddress(): void
	{

		try {

			$whisperedAddressResponse = $this->addressClient->whisper(new WhisperAddress(
				new WhisperAddressByWholeAddress('Na Pavím vrchu 1949/2'),
				country: Country::CzechRepublic,
			));

			$addresses = $whisperedAddressResponse->getResult();

			foreach($addresses as $address) {
				dump([
					$address->wholeAddress, // Na Pavím vrchu 1949/2, 15000 Praha 5 - Smíchov
				]);
				break;
			}

		} catch (ClientException $e) {
			dump($e->getCode());
			dump($e->getMessage());
		}

	}

	public function tryValidateCompany(): void
	{

		try {

			$validatedCompanyResponse = $this->companyClient->validate(
			  new ValidateCompany(registrationNumber: '75848015')
			);

			$companies = $whisperedAddressResponse->getResult();

			foreach($companies as $company) {
				dump([
					$company->registrationNumber, // 75848015
					$company->naceCodes, // 27900, 620
				]);
				break;
			}

		} catch (ClientException $e) {
			dump($e->getCode());
			dump($e->getMessage());
		}

	}

}