myckhel/checkmobi

CheckMobi API 基于HTTP方法,便于集成到您自己的产品中。

赞助包维护!
Ko Fi

安装: 484

依赖: 0

建议者: 0

安全: 0

星级: 8

关注者: 1

分支: 3

开放问题: 0

类型:

v0.3 2024-05-12 07:52 UTC

This package is auto-updated.

Last update: 2024-09-12 08:30:57 UTC


README

Latest Version on Packagist Software License Tests Status Total Downloads

CheckMobi 文档链接

安装

通过 Composer $ composer require myckhel/checkmobi

设置

包将自动注册服务提供者。

您需要发布配置文件

php artisan vendor:publish --provider="Myckhel\CheckMobi\CheckMobiServiceProvider"

这是配置文件 checkmobi.php 的默认内容

<?php

return [
  "secret_key"          => env("CHECKMOBI_SECRET_KEY"),
  "retry_after"         => 120, // option to set the retry limit for each phone number verification
    /* coming soon */
  "route_middleware"    => 'auth:api', // For injecting middleware to the package's routes
];

更新项目的 .env 文件

CHECKMOBI_SECRET_KEY=XXXXXXXXXXXXXXXXXXXX

运行数据库迁移 php artisan migrate

可用的 API

use CheckMobi;
use Myckhel\CheckMobi\Support\MissedCall;

CheckMobi::requestValidation($params);

CheckMobi::verifyValidation($params);

CheckMobi::getAccountDetails($params);

CheckMobi::getCountriesList($params);

CheckMobi::getPrefixes($params);

CheckMobi::checkNumber($params);

CheckMobi::validationStatus($validationId, $params);

CheckMobi::sendSMS($params);

CheckMobi::getSmsDetails($params);

CheckMobi::placeCall($params);

CheckMobi::getCallDetails($callId, $params);

CheckMobi::hangUpCall($callId, $params);

MissedCall::request($params);

MissedCall::verify($params);

API 使用示例

MissedCall

use Myckhel\CheckMobi\Support\MissedCall;
use CheckMobi;

class VerificationController {

  public function request(){

    return MissedCall::request([
        'number'                  => '+1 234 567 890', // E. 164 format
        'platform'                => 'web',
    ]);
  }

  public function verify(){

    return MissedCall::verify([
        'id'    => 'SMS-FF9137C1-4D39-42B0-BE86-4B5A96CE13BD', // E. 164 format
        'pin'   => '9711',
    ]);
  }

  public function exampleCheckMobi(){

    $validationResponse = CheckMobi::requestValidation([
          'number'                  => '+1 234 567 890', // E. 164 format
          'type'                    => 'reverse_cli',
          'platform'                => 'web',
    ]);

    $verificationResponse = CheckMobi::verifyValidation([
      "id": "SMS-FF9137C1-4D39-42B0-BE86-4B5A96CE13BD", // $validationResponse->id
      "pin":"9711"
    ]);
  }
}

响应示例

请求

{
  "id": "RCL-B772A954-7E63-4114-8087-BAF415B5003F",
  "type": "reverse_cli",
  "pin_hash": "6f8246002c1c5967ffc5e0ec80f2d7b59a60b1e3",
  "validation_info": {
      "country_code": 40,
      "country_iso_code": "RO",
      "carrier": "Orange",
      "is_mobile": true,
      "e164_format": "+40743XXXXXX",
      "formatting": "+40 743 XXX XXX"
  }
}

验证

{
    "number":"+40XXXXXXXXX",
    "validated":true,
    "validation_date":1416946931,
    "charged_amount": 0.1
}

待办事项

  • 即将推出

测试

使用以下命令运行测试

vendor/bin/phpunit

变更日志

请查看 CHANGELOG 了解最近更改的详细信息。

贡献

请查看 CONTRIBUTING 了解详细信息。

鸣谢

安全

如果您发现任何安全问题,请通过电子邮件 myckhel1@hotmail.com 联系我们,而不是使用问题跟踪器。

许可证

MIT 许可证(MIT)。请参阅 许可证文件 了解更多信息。