@fill-easy/api 1.0.32 → 1.0.33
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/openapi.d.ts +0 -351
- package/package.json +1 -1
package/dist/openapi.d.ts
CHANGED
|
@@ -742,83 +742,6 @@ export interface paths {
|
|
|
742
742
|
patch?: never;
|
|
743
743
|
trace?: never;
|
|
744
744
|
};
|
|
745
|
-
"/ocr/request": {
|
|
746
|
-
parameters: {
|
|
747
|
-
query?: never;
|
|
748
|
-
header?: never;
|
|
749
|
-
path?: never;
|
|
750
|
-
cookie?: never;
|
|
751
|
-
};
|
|
752
|
-
get?: never;
|
|
753
|
-
put?: never;
|
|
754
|
-
/**
|
|
755
|
-
* Request
|
|
756
|
-
* @description Initialize a verification session by passing your callback URLs and the
|
|
757
|
-
* document type.
|
|
758
|
-
*
|
|
759
|
-
*
|
|
760
|
-
* **Browser Flow:**
|
|
761
|
-
*
|
|
762
|
-
* Returns a **launch URL** (open on a **mobile browser**) and a **JWT**
|
|
763
|
-
* **`token`** that you must keep for polling status.
|
|
764
|
-
* After the user completes or cancels the H5 flow, the browser is
|
|
765
|
-
* redirected to your provided callback URL.
|
|
766
|
-
*
|
|
767
|
-
*
|
|
768
|
-
* **Mobile App Flow:**
|
|
769
|
-
*
|
|
770
|
-
* Use the returned **`url`** to open an in-app web view or the system
|
|
771
|
-
* browser on the phone.
|
|
772
|
-
* Use the returned **`token`** later with `/ocr/poll` to check the final
|
|
773
|
-
* decision.
|
|
774
|
-
*
|
|
775
|
-
*
|
|
776
|
-
* **Note:** The redirect is **UX-only**; you still need to call `/ocr/poll` with the
|
|
777
|
-
* returned `token` to obtain the authoritative decision.
|
|
778
|
-
*/
|
|
779
|
-
post: operations["request1"];
|
|
780
|
-
delete?: never;
|
|
781
|
-
options?: never;
|
|
782
|
-
head?: never;
|
|
783
|
-
patch?: never;
|
|
784
|
-
trace?: never;
|
|
785
|
-
};
|
|
786
|
-
"/ocr/poll": {
|
|
787
|
-
parameters: {
|
|
788
|
-
query?: never;
|
|
789
|
-
header?: never;
|
|
790
|
-
path?: never;
|
|
791
|
-
cookie?: never;
|
|
792
|
-
};
|
|
793
|
-
get?: never;
|
|
794
|
-
put?: never;
|
|
795
|
-
/**
|
|
796
|
-
* Poll
|
|
797
|
-
* @description Check the status of a verification using the **`token`** returned by
|
|
798
|
-
* `/ocr/request`.
|
|
799
|
-
*
|
|
800
|
-
*
|
|
801
|
-
* - Returns **202 Accepted** while the verification is **in progress**.
|
|
802
|
-
*
|
|
803
|
-
* - Returns **200 OK** when the verification is **completed** (Success /
|
|
804
|
-
* Failure / Void\*).
|
|
805
|
-
*
|
|
806
|
-
* - Always responds with a concise **`summary`** (no raw payloads needed).
|
|
807
|
-
*
|
|
808
|
-
*
|
|
809
|
-
* Send **only the** **`token`**. It already encapsulates the session
|
|
810
|
-
* identifiers.
|
|
811
|
-
*
|
|
812
|
-
*
|
|
813
|
-
* **Terminal states:** `Success`, `Failure`, or `Void\*`.
|
|
814
|
-
*/
|
|
815
|
-
post: operations["ocrPoll"];
|
|
816
|
-
delete?: never;
|
|
817
|
-
options?: never;
|
|
818
|
-
head?: never;
|
|
819
|
-
patch?: never;
|
|
820
|
-
trace?: never;
|
|
821
|
-
};
|
|
822
745
|
"/kyc/cn/identity": {
|
|
823
746
|
parameters: {
|
|
824
747
|
query?: never;
|
|
@@ -2577,280 +2500,6 @@ export interface operations {
|
|
|
2577
2500
|
500: components["responses"]["InternalServerError"];
|
|
2578
2501
|
};
|
|
2579
2502
|
};
|
|
2580
|
-
request1: {
|
|
2581
|
-
parameters: {
|
|
2582
|
-
query?: never;
|
|
2583
|
-
header?: never;
|
|
2584
|
-
path?: never;
|
|
2585
|
-
cookie?: never;
|
|
2586
|
-
};
|
|
2587
|
-
requestBody: {
|
|
2588
|
-
content: {
|
|
2589
|
-
"application/json": {
|
|
2590
|
-
/**
|
|
2591
|
-
* Format: uri
|
|
2592
|
-
* @description Where to redirect the user **after success**.
|
|
2593
|
-
* Must be publicly reachable over **https**.
|
|
2594
|
-
* @example https://example.com/ocr/complete
|
|
2595
|
-
*/
|
|
2596
|
-
completeCallbackUrl: string;
|
|
2597
|
-
/**
|
|
2598
|
-
* Format: uri
|
|
2599
|
-
* @description Where to redirect the user if they **cancel/exit**.
|
|
2600
|
-
* Must be publicly reachable over **https**.
|
|
2601
|
-
* @example https://example.com/ocr/interrupt
|
|
2602
|
-
*/
|
|
2603
|
-
interruptCallbackUrl: string;
|
|
2604
|
-
/**
|
|
2605
|
-
* @description The identity document type to verify.
|
|
2606
|
-
* `00000001003` (Passport), `08520000002` (HKID New), `08520000001` (HKID Old).
|
|
2607
|
-
* Use the exact code for your target document.
|
|
2608
|
-
* @example 08520000002
|
|
2609
|
-
* @enum {string}
|
|
2610
|
-
*/
|
|
2611
|
-
docType: "00000001003" | "08520000002" | "08520000001";
|
|
2612
|
-
};
|
|
2613
|
-
};
|
|
2614
|
-
};
|
|
2615
|
-
responses: {
|
|
2616
|
-
/** @description Successfully initialized verification session */
|
|
2617
|
-
200: {
|
|
2618
|
-
headers: {
|
|
2619
|
-
[name: string]: unknown;
|
|
2620
|
-
};
|
|
2621
|
-
content: {
|
|
2622
|
-
"application/json": {
|
|
2623
|
-
/**
|
|
2624
|
-
* Format: uri
|
|
2625
|
-
* @description Launch URL to open on a mobile browser or in an in-app web view.
|
|
2626
|
-
* This URL contains the configuration for the H5 verification flow.
|
|
2627
|
-
* @example https://<cdn>/page/realid-fe/index.html?clientcfg=eyJ...
|
|
2628
|
-
*/
|
|
2629
|
-
url: string;
|
|
2630
|
-
/**
|
|
2631
|
-
* @description JWT token carrying bizId and transactionId.
|
|
2632
|
-
* Store this token to poll for verification results using `/ocr/poll`.
|
|
2633
|
-
*/
|
|
2634
|
-
token: components["schemas"]["Token"];
|
|
2635
|
-
};
|
|
2636
|
-
};
|
|
2637
|
-
};
|
|
2638
|
-
};
|
|
2639
|
-
};
|
|
2640
|
-
ocrPoll: {
|
|
2641
|
-
parameters: {
|
|
2642
|
-
query?: never;
|
|
2643
|
-
header?: never;
|
|
2644
|
-
path?: never;
|
|
2645
|
-
cookie?: never;
|
|
2646
|
-
};
|
|
2647
|
-
requestBody: {
|
|
2648
|
-
content: {
|
|
2649
|
-
"application/json": {
|
|
2650
|
-
/** @description The token returned by `POST /ocr/request` that encodes the session identifiers */
|
|
2651
|
-
token: components["schemas"]["Token"];
|
|
2652
|
-
};
|
|
2653
|
-
};
|
|
2654
|
-
};
|
|
2655
|
-
responses: {
|
|
2656
|
-
/** @description Verification completed (Success / Failure / Void\*) */
|
|
2657
|
-
200: {
|
|
2658
|
-
headers: {
|
|
2659
|
-
[name: string]: unknown;
|
|
2660
|
-
};
|
|
2661
|
-
content: {
|
|
2662
|
-
"application/json": {
|
|
2663
|
-
/**
|
|
2664
|
-
* @description Status message
|
|
2665
|
-
* @example Verification completed
|
|
2666
|
-
*/
|
|
2667
|
-
message: string;
|
|
2668
|
-
summary: {
|
|
2669
|
-
/**
|
|
2670
|
-
* @description Overall eKYC verification result
|
|
2671
|
-
* @example Success
|
|
2672
|
-
* @enum {string}
|
|
2673
|
-
*/
|
|
2674
|
-
ekycResult: "Success" | "Failure" | "Void";
|
|
2675
|
-
/**
|
|
2676
|
-
* @description Whether this is a terminal state (true for completed verifications)
|
|
2677
|
-
* @example true
|
|
2678
|
-
*/
|
|
2679
|
-
isTerminal: boolean;
|
|
2680
|
-
/** @description Document verification details */
|
|
2681
|
-
document: {
|
|
2682
|
-
/**
|
|
2683
|
-
* @description Document type code
|
|
2684
|
-
* @example 08520000002
|
|
2685
|
-
*/
|
|
2686
|
-
type?: string;
|
|
2687
|
-
/**
|
|
2688
|
-
* @description Document number (may be partially masked)
|
|
2689
|
-
* @example F*********
|
|
2690
|
-
*/
|
|
2691
|
-
number?: string;
|
|
2692
|
-
/**
|
|
2693
|
-
* @description Name of the document holder
|
|
2694
|
-
* @example John, Smith
|
|
2695
|
-
*/
|
|
2696
|
-
holderName?: string;
|
|
2697
|
-
/**
|
|
2698
|
-
* @description Date of birth (YYYY/MM/DD format)
|
|
2699
|
-
* @example 2000/01/01
|
|
2700
|
-
*/
|
|
2701
|
-
dob?: string;
|
|
2702
|
-
/**
|
|
2703
|
-
* @description Gender
|
|
2704
|
-
* @example M
|
|
2705
|
-
*/
|
|
2706
|
-
sex?: string | null;
|
|
2707
|
-
/**
|
|
2708
|
-
* @description Document issue date (YYYY/MM/DD format)
|
|
2709
|
-
* @example 2021/11/11
|
|
2710
|
-
*/
|
|
2711
|
-
dateOfIssue?: string | null;
|
|
2712
|
-
/**
|
|
2713
|
-
* @description Document expiry date (YYYY/MM/DD format)
|
|
2714
|
-
* @example 2031/11/11
|
|
2715
|
-
*/
|
|
2716
|
-
dateOfExpiry?: string | null;
|
|
2717
|
-
/**
|
|
2718
|
-
* @description Document verification decision
|
|
2719
|
-
* @example Success
|
|
2720
|
-
* @enum {string|null}
|
|
2721
|
-
*/
|
|
2722
|
-
decision?: "Success" | "Failure" | null;
|
|
2723
|
-
};
|
|
2724
|
-
/** @description Face verification details */
|
|
2725
|
-
face: {
|
|
2726
|
-
/**
|
|
2727
|
-
* @description Liveness check result
|
|
2728
|
-
* @example Success
|
|
2729
|
-
* @enum {string|null}
|
|
2730
|
-
*/
|
|
2731
|
-
liveness?: "Success" | "Failure" | null;
|
|
2732
|
-
/**
|
|
2733
|
-
* @description Liveness detection score
|
|
2734
|
-
* @example 25
|
|
2735
|
-
*/
|
|
2736
|
-
livenessScore?: number | null;
|
|
2737
|
-
/**
|
|
2738
|
-
* @description Face match score (0-100)
|
|
2739
|
-
* @example 94
|
|
2740
|
-
*/
|
|
2741
|
-
matchScore?: number | null;
|
|
2742
|
-
};
|
|
2743
|
-
/** @description Risk assessment details */
|
|
2744
|
-
risk: {
|
|
2745
|
-
/**
|
|
2746
|
-
* @description Risk assessment decision
|
|
2747
|
-
* @example Success
|
|
2748
|
-
* @enum {string|null}
|
|
2749
|
-
*/
|
|
2750
|
-
decision?: "Success" | "Failure" | null;
|
|
2751
|
-
};
|
|
2752
|
-
};
|
|
2753
|
-
};
|
|
2754
|
-
};
|
|
2755
|
-
};
|
|
2756
|
-
/** @description Verification in progress */
|
|
2757
|
-
202: {
|
|
2758
|
-
headers: {
|
|
2759
|
-
[name: string]: unknown;
|
|
2760
|
-
};
|
|
2761
|
-
content: {
|
|
2762
|
-
"application/json": {
|
|
2763
|
-
/**
|
|
2764
|
-
* @description Status message
|
|
2765
|
-
* @example Verification in progress
|
|
2766
|
-
*/
|
|
2767
|
-
message: string;
|
|
2768
|
-
summary: {
|
|
2769
|
-
/**
|
|
2770
|
-
* @description Current eKYC verification status
|
|
2771
|
-
* @example InProcess
|
|
2772
|
-
*/
|
|
2773
|
-
ekycResult: string;
|
|
2774
|
-
/**
|
|
2775
|
-
* @description Whether this is a terminal state (false for in-progress verifications)
|
|
2776
|
-
* @example false
|
|
2777
|
-
*/
|
|
2778
|
-
isTerminal: boolean;
|
|
2779
|
-
/** @description Document verification details (partial data during processing) */
|
|
2780
|
-
document: {
|
|
2781
|
-
/**
|
|
2782
|
-
* @description Document type code
|
|
2783
|
-
* @example 08520000002
|
|
2784
|
-
*/
|
|
2785
|
-
type?: string;
|
|
2786
|
-
/**
|
|
2787
|
-
* @description Document number (may be partially masked or incomplete)
|
|
2788
|
-
* @example F*******
|
|
2789
|
-
*/
|
|
2790
|
-
number?: string;
|
|
2791
|
-
/**
|
|
2792
|
-
* @description Name of the document holder (may be incomplete)
|
|
2793
|
-
* @example —
|
|
2794
|
-
*/
|
|
2795
|
-
holderName?: string;
|
|
2796
|
-
/**
|
|
2797
|
-
* @description Date of birth (may be incomplete)
|
|
2798
|
-
* @example —
|
|
2799
|
-
*/
|
|
2800
|
-
dob?: string;
|
|
2801
|
-
/**
|
|
2802
|
-
* @description Gender
|
|
2803
|
-
* @example M
|
|
2804
|
-
*/
|
|
2805
|
-
sex?: string | null;
|
|
2806
|
-
/**
|
|
2807
|
-
* @description Document issue date
|
|
2808
|
-
* @example 2031/11/11
|
|
2809
|
-
*/
|
|
2810
|
-
dateOfIssue?: string | null;
|
|
2811
|
-
/**
|
|
2812
|
-
* @description Document expiry date
|
|
2813
|
-
* @example 2031/11/11
|
|
2814
|
-
*/
|
|
2815
|
-
dateOfExpiry?: string | null;
|
|
2816
|
-
/**
|
|
2817
|
-
* @description Document verification decision (null during processing)
|
|
2818
|
-
* @example pass
|
|
2819
|
-
*/
|
|
2820
|
-
decision?: string | null;
|
|
2821
|
-
};
|
|
2822
|
-
/** @description Face verification details (null during processing) */
|
|
2823
|
-
face: {
|
|
2824
|
-
/**
|
|
2825
|
-
* @description Liveness check result
|
|
2826
|
-
* @example pass
|
|
2827
|
-
*/
|
|
2828
|
-
liveness?: string | null;
|
|
2829
|
-
/**
|
|
2830
|
-
* @description Liveness detection score
|
|
2831
|
-
* @example 50
|
|
2832
|
-
*/
|
|
2833
|
-
livenessScore?: number | null;
|
|
2834
|
-
/**
|
|
2835
|
-
* @description Face match score
|
|
2836
|
-
* @example 100
|
|
2837
|
-
*/
|
|
2838
|
-
matchScore?: number | null;
|
|
2839
|
-
};
|
|
2840
|
-
/** @description Risk assessment details (null during processing) */
|
|
2841
|
-
risk: {
|
|
2842
|
-
/**
|
|
2843
|
-
* @description Risk assessment decision
|
|
2844
|
-
* @example pass
|
|
2845
|
-
*/
|
|
2846
|
-
decision?: string | null;
|
|
2847
|
-
};
|
|
2848
|
-
};
|
|
2849
|
-
};
|
|
2850
|
-
};
|
|
2851
|
-
};
|
|
2852
|
-
};
|
|
2853
|
-
};
|
|
2854
2503
|
kycCnIdentity: {
|
|
2855
2504
|
parameters: {
|
|
2856
2505
|
query?: never;
|