# 공통 파라미터

## 호출시 공통 파라미터

### appParamURL(string, 1\~256bytes)

* 이 파라미터가 사용되면 다른 모든 파라미터는 무시되며 이 파라미터에 명시된 URL의 반환값을 대신 파라미터로 이용하게 됩니다.
* 파라미터가 너무 길어서 QRCode로 만들었을때 인식하기 힘든경우 유용하게 사용됩니다.
* 이 파라미터의 반환값은 다음과 유사합니다.
  *  appAction=Login\&appName=TestApp

### `필수` appAction(string, 1\~32bytes)

* MetaWallet 에서 처리할 작업을 명시합니다.
* 각 작업별로 명시된 값을 사용합니다.

### appCallbackType(string, 아래 명시된 값 중 하나 혹은 빈 문자열)

* MetaWallet 에서 결과를 통보할때 사용할 방식을 지정합니다.
* 아래 명시된 값 이외의 값 중 하나가 사용되어야 합니다.
  * universallink
    * iOS가 아닌경우 무시되며, 오류가 발생됩니다.
    * 'callback' 파라미터의 값을 Apple Universal Link 값으로 이용하여 통보합니다.
  * url
    * Web, iOS, Android 가 아닌경우 무시되며, 오류가 발생됩니다.
    * 'callback' 파라미터의 값을 URL로 판단하여 결과를 POST 방식으로 통보합니다.
  * deeplink
    * Android 가 아닌경우 무시되며, 오류가 발생됩니다.
    * 파라미터의 값을 DeepLink 로 판단하여 결과를 전달합니다.
  * intent
    * Android 가 아닌경우 무시되며, 오류가 발생됩니다.
    * [setResult](https://developer.android.com/reference/android/app/Activity?hl=ko#setResult\(int,%20android.content.Intent\)) 를 이용하여 결과를 반환합니다.
  * 빈 문자열
    * iOS의 경우 universallink 로 설정한것과 동일합니다.
    * Android의 경우 intent 로 설정한것과 동일합니다.

### appCallback(string, 0\~255bytes)

* 결과값을 반환할때 사용할 식별자를 지정합니다.
* `callbackType` 값에 따라 각각 다음과 같은 형식이어야 합니다.
  * universallink
    * Apple Universal Link 에서 사용할 URL Scheme 값
  * url
    * 결과값을 GET으로 전달하며, http/https 프로토콜을 사용해야 합니다.
  * deeplink
    * Android 에서 사용할 URL Scheme 값
  * intent
    * 이 값은 무시됩니다.

### appReqKey(string, 0\~64 bytes)

* 결과를 수신했을때 자신이 호출한값인지 여부를 알기 위해 사용됩니다.
* 이 값은 생략될 수 있습니다.

### `필수` appName(string)

* Metawallet 에서 표기할 호출자의 명칭입니다

### appIcon(string, url 형식)

* Metawallet 에서 표기할 호출자의 이미지입니다.
* 명시되지 않는경우 기본 이미지가 표시됩니다.

### appTopic(string, 선택)

* Metawallet 에서 표기할 작업의 설명입니다.
* 작업에 따라 사용되지 않는경우도 있습니다.

### network(string, 아래에 명시된 값 중 하나)

* 메타코인 네트워크를 명시합니다
* 작업에 따라 사용되지 않는경우도 있습니다.
* 아래 명시된 값 이외의 값 중 하나가 사용되어야 합니다.
  * "0"
    * 사용자가 선택할 수 있도록 합니다.
    * 작업에 따라 사용할 수 없는 경우가 있습니다.
  * "1"
    * MainNet
  * "5"
    * TestNet

## 응답시 공통 파라미터

### code(string, 4bytes)

* 결과 값에 대한 성공/실패/취소 여부를 의미합니다.
* 아래 명시된 값 이외의 값은 해당 API의 설명에 따릅니다.
  * 0000: 성공
  * 9999: 취소

### acion 

* appAction 에 명시된 값을 반환합니다. 
* 이것은 여러번 지갑을 호출한경우 어떤 호출에 대한 응답인지 식별하는데 사용됩니다.

### message(string, 0\~255 bytes)

* 성공시 빈 문자열이 반환됩니다.
* 실패시 오류 메시지를 반환합니다.

### appReqKey(string)

* 결과를 수신했을때 자신이 호출한값인지 여부를 알기 위해 사용됩니다.
* 호출시 넘겨준 appReqKey 의 값이 그대로 반환 됩니다.

### network(string, 1byte)

* 메타코인 네트워크를 명시합니다
* 아래 명시된 값 이외의 값 중 하나 입니다.
  * "1"
    * MainNet
  * "5"
    * TestNet

### networkName(string)

* 메타코인 네트워크 이름을 반환합니다.
* 아래 명시된 값 이외의 값 중 하나 입니다.
  * MainNet
  * TestNet

### txid(string)

* Metacoin Network 에서 밯생된 Transaction ID 입니다.
* 작업에따라 빈 값이 반환될 수 있습니다.

### data(string)

* 작업에 따라 요청한 값이 설정됩니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api.metacoin.network/metawallet-deeplink/undefined-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.