==========
[pin.basic]
==========

PIN 제품에 대한 필수 API 를 정의

.. warning::  PIN 인증은 내부적으로 암호화하여 작동하나, 클라이언트 단독으로 작동하므로, 보안이 필수인 경우는 3rd party 인증 제품을 사용하시기 바랍니다.


------------------------------------
PIN API
------------------------------------

PIN 인증 대한 연동 기능을 제공한다.




.. _statusType:

status Type
------------


============  ===================
Type          Description             
============  ===================
PROCESSING    	진행 중
SUCCESS    		정상 처리됨
FAIL     		처리 중 문제가 발생함
============  ===================


PIN 번호 등록 
--------------

.. js:function:: M.plugin('3rd_pin_basic').register( setting )

	.. versionchanged:: 1.0.0
	
	:param Object setting: 설정 정보
	:param Int setting.length: 입력 받을 핀넘버 길이 
	:param String setting.page: custom activity 명 (필수 아님, AndroidManifest.xml 에 activity 선언 필요) 
	:param Function setting.callback: 결과 콜백 함수
	
	.. js:function:: callback(status, result)
		
		:param String status: API 호출에 대한 결과값
		:param Object result.result: 3rd Party 모듈 수행 결과 값   
		:param String result.message: 3rd Party 모듈 수행에 에러가 있을 경우 에러 메세지
		
		
Example: 핀번호 등록 

    .. code-block:: javascript
        
        M.plugin('3rd_pin_basic').register({
            length: 4,
            callback:function(status, result){
                console.log(result);
            }
        });


Example: Custom 핀번호 등록 

    .. code-block:: javascript
        
        M.plugin('3rd_pin_basic').register({
            length: 4,
            page: 'CustomPinActivity',
            callback:function(status, result){
                console.log(result);
            }
        });

PIN 번호 삭제
--------------

.. js:function:: M.plugin('3rd_pin_basic').remove( setting )

	.. versionchanged:: 1.0.0
	
	:param Object setting: 설정 정보
	:param Function setting.callback: 결과 콜백 함수
	
	.. js:function:: callback(status, result)
		
		:param String status: API 호출에 대한 결과값
		:param Object result.result: 3rd Party 모듈 수행 결과 값   
		:param String result.message: 3rd Party 모듈 수행에 에러가 있을 경우 에러 메세지
		
		
Example: 핀번호 등록 

    .. code-block:: javascript
        
        M.plugin('3rd_pin_basic').remove({
            callback:function(status, result){
                console.log(result);
            }
        });


PIN 번호 가져오기
--------------

.. js:function:: M.plugin('3rd_pin_basic').get( setting )

	.. versionchanged:: 1.0.0
	
	:param Object setting: 설정 정보
	:param Function setting.callback: 결과 콜백 함수
	
	.. js:function:: callback(status, result)
		
		:param String status: API 호출에 대한 결과값
		:param Object result.result: 3rd Party 모듈 수행 결과 값   
		:param String result.message: 3rd Party 모듈 수행에 에러가 있을 경우 에러 메세지
		
		
Example: 핀번호 등록 

    .. code-block:: javascript
        
        M.plugin('3rd_pin_basic').get({
            callback:function(status, result){
                console.log(result);
            }
        });


PIN 번호 인증
--------------

.. js:function:: M.plugin('3rd_pin_basic').auth( setting )

	.. versionchanged:: 1.0.0
	
	:param Object setting: 설정 정보
	:param Int setting.length: 입력 받을 핀넘버 길이 	
	:param String setting.page: custom activity 명 (필수 아님, AndroidManifest.xml 에 activity 선언 필요) 
	:param Function setting.callback: 결과 콜백 함수
	
	.. js:function:: callback(status, result)
		
		:param String status: API 호출에 대한 결과값
		:param Object result.result: 3rd Party 모듈 수행 결과 값   
		:param String result.message: 3rd Party 모듈 수행에 에러가 있을 경우 에러 메세지
		
		
Example: 핀번호 등록 

    .. code-block:: javascript
        
        M.plugin('3rd_pin_basic').auth({
            length: 4,
            callback:function(status, result){
                console.log(result);
            }
        });

Example: Custom 핀번호 등록 

    .. code-block:: javascript
        
        M.plugin('3rd_pin_basic').auth({
            length: 4,
            page: 'CustomPinActivity',
            callback:function(status, result){
                console.log(result);
            }
        });