> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 기여 결과 가져오기

Device UUID로 기여된 결과를 가져올 수 있습니다.

Attribution Result API는 Authorization Header로 `AIRBRIDGE-API-KEY` 와 `AIRBRDGE-SDK-TOKEN`을 받을 수 있습니다. `AIRBRIDGE-API-KEY`를 사용하는 경우 `API Token`을 사용하고 `AIRBRIDGE-SDK-TOKEN`를 사용하는 경우 `SDK Token`을 사용합니다.

호출의 예시는 아래와 같습니다.

```zsh lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
curl -H "Authorization: AIRBRIDGE-API-KEY {API-TOKEN}" https://api.airbridge.io
```

기여 결과를 가져옵니다.

<Card title="Try API Request" icon="rectangle-api" horizontal href="https://www.postman.com/airbridge-engineering/workspace/airbridge-api/request/22395869-f0035cf5-05ca-4d43-86f5-e2730371ab93" />

```text GET theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
https://api.airbridge.io/attribution-result/v1/apps/{app_name}/mobile-app
```

<h2 id="기여-결과-가져오기-request">
  Request
</h2>

***

<h3 id="기여-결과-가져오기-headers">
  Headers
</h3>

<ParamField header="Accept-Language" type="string">
  API 요청 및 결과 반환에 사용할 언어를 지정할 수 있습니다. ISO-639-1 포맷을 따릅니다.
</ParamField>

<ParamField header="Content-Type" type="string">
  리소스의 미디어 타입을 나타냅니다. 기본값으로 `application/json`을 사용합니다.
</ParamField>

<ParamField header="Authorization" type="string">
  API 요청에 사용하는 키값입니다. [키값 생성 및 조회 방법](/ko/references/introduction)을 확인하여 획득할 수 있습니다.
</ParamField>

<h3 id="기여-결과-가져오기-path-params">
  Path Params
</h3>

<ParamField path="app_name" type="string" required>
  에어브릿지 앱 이름(App Name)
</ParamField>

<h3 id="기여-결과-가져오기-query-params">
  Query Params
</h3>

<ParamField query="device_uuid" type="string" required>
  Android 혹은 iOS의 Device UUID.

  앱 SDK를 통해 획득한 디바이스 UUID입니다. OS별로 획득하는 방법은 아래 가이드를 참조해주시기 바랍니다.

  * [Android SDK Device UUID Fetching 가이드](https://developers.airbridge.io/docs/data-fetching-guide-for-android-sdk#airbridge-device-id)
  * [iOS SDK Device UUID Fetching 가이드](https://developers.airbridge.io/docs/data-fetching-guide-for-ios-sdk#airbridge-device-id)
</ParamField>

<RequestExample>
  ```shellscript Request theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  curl -X GET 'https://api.airbridge.io/attribution-result/v1/apps/{app_name}/mobile-app?device_uuid=f3fab994-baea-4b52-b190-5f023b6ae638' \
    -H 'Accept-Language: ko' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}'
  ```
</RequestExample>

<h2 id="기여-결과-가져오기-response">
  Response
</h2>

***

### 200

### 204

기여 결과를 찾을 수 없는 경우, API는 204 No Content 응답을 반환합니다. 이는 유효한 요청이지만 해당 조건에 맞는 기여 데이터가 없음을 의미합니다.

### 400

### 401

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "at": "2023-01-01T09:30:00.123Z",
    "data": {
      "attributedTerm": null,
      "attributedAdGroup": "TEST_ADGROUP",
      "attributedChannel": "website",
      "attributedContent": null,
      "attributedCampaign": "TEST_CAMPAIGN",
      "attributedAdCreative": "TEST_ADCREATIVE",
      "attributedSubPublisher": null,
      "attributedSubSubPublisher1": null,
      "attributedSubSubPublisher2": null,
      "attributedSubSubPublisher3": null
    }
  }
  ```

  ```json 204 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {}
  ```

  ```json 400 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "result": "Invalid device_uuid"
  }
  ```

  ```json 401 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "result": "invalid authorization header"
  }
  ```
</ResponseExample>
