@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.
Files changed (2) hide show
  1. package/dist/openapi.d.ts +0 -351
  2. 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;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fill-easy/api",
3
- "version": "1.0.32",
3
+ "version": "1.0.33",
4
4
  "type": "module",
5
5
  "description": "Type-safe SDK for Fill Easy API",
6
6
  "main": "dist/index.js",