# Lấy định danh tích hợp

> Truy xuất các định danh tích hợp của một hồ sơ người dùng.

## OpenAPI

```yaml
/api-specs/adapty-api.yaml get /api/v2/server-side-api/integration/profile/set/integration-identifiers/
openapi: 3.1.0
info:
  title: Adapty server-side API
  version: 1.0.0
servers:
  - url: https://api.adapty.io
    description: Máy chủ sản xuất
paths:
  /api/v2/server-side-api/integration/profile/set/integration-identifiers/:
    get:
      summary: Lấy định danh tích hợp
      description: Truy xuất các định danh tích hợp của một hồ sơ người dùng.
      operationId: getIntegrationIdentifiers
      tags:
        - Integration
      security:
        - apikeyAuth: []
      parameters:
        - name: adapty-customer-user-id
          in: header
          required: false
          schema:
            type: string
          description: ID duy nhất của khách hàng trong hệ thống của bạn. Cần cung cấp `adapty-customer-user-id` hoặc `adapty-profile-id`.
        - name: adapty-profile-id
          in: header
          required: false
          schema:
            type: string
            format: uuid
          description: ID duy nhất của hồ sơ người dùng trong hệ thống của bạn. Lựa chọn tốt nhất khi làm việc với hồ sơ ẩn danh. Cần cung cấp `adapty-customer-user-id` hoặc `adapty-profile-id`.
      responses:
        "200":
          description: Các định danh tích hợp được truy xuất thành công
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/IntegrationIdentifiersResponse"
              example:
                facebook_anonymous_id: XZ7EF7D15E-8FA1-49D8-B180-918EB333E42A
                amplitude_user_id: null
                amplitude_device_id: null
                mixpanel_user_id: 33w6yv5DPqVlyMVbjW31xvzJLtJ3
                appmetrica_profile_id: null
                appmetrica_device_id: null
                one_signal_player_id: null
                one_signal_subscription_id: 333ed338-757d-466a-a672-ab92db196a1f
                pushwoosh_hwid: null
                firebase_app_instance_id: C333B35DF1DB418E99F7B815E9F5C549
                airbridge_device_id: null
                appsflyer_id: 1741933337626-3179568
                branch_id: null
                adjust_device_id: null
                tenjin_analytics_installation_id: null
                posthog_distinct_user_id: null
        "401":
          description: Không được phép
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
              example:
                errors:
                  - Invalid API key
                error_code: unauthorized
                status_code: 401
        "404":
          description: Không tìm thấy hồ sơ người dùng
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
              example:
                errors:
                  - Profile not found
                error_code: profile_not_found
                status_code: 404
        "500":
          description: Lỗi máy chủ nội bộ
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
components:
  schemas:
    IntegrationIdentifiersResponse:
      type: object
      properties:
        adjust_device_id:
          type: string
          nullable: true
          description: ID người dùng mạng trong tích hợp Adjust
        airbridge_device_id:
          type: string
          nullable: true
          description: ID thiết bị của người dùng trong tích hợp Airbridge
        amplitude_device_id:
          type: string
          nullable: true
          description: ID thiết bị của người dùng trong tích hợp Amplitude
        amplitude_user_id:
          type: string
          nullable: true
          description: ID người dùng trong tích hợp Amplitude
        appmetrica_device_id:
          type: string
          nullable: true
          description: ID thiết bị của người dùng trong tích hợp AppMetrica
        appmetrica_profile_id:
          type: string
          nullable: true
          description: ID người dùng trong tích hợp AppMetrica
        appsflyer_id:
          type: string
          nullable: true
          description: ID người dùng mạng trong tích hợp AppsFlyer
        branch_id:
          type: string
          nullable: true
          description: Branch Key của ứng dụng người dùng trong tích hợp Branch
        facebook_anonymous_id:
          type: string
          nullable: true
          description: ID người dùng trong tích hợp Facebook Ads
        firebase_app_instance_id:
          type: string
          nullable: true
          description: ID người dùng trong tích hợp Firebase
        mixpanel_user_id:
          type: string
          nullable: true
          description: ID người dùng trong tích hợp Mixpanel
        one_signal_player_id:
          type: string
          nullable: true
          description: ID người dùng trong tích hợp OneSignal (Định danh kế thừa)
        one_signal_subscription_id:
          type: string
          nullable: true
          description: ID người dùng trong tích hợp OneSignal (Định danh khuyến nghị)
        posthog_distinct_user_id:
          type: string
          nullable: true
          description: ID người dùng trong tích hợp PostHog
        pushwoosh_hwid:
          type: string
          nullable: true
          description: ID thiết bị của người dùng trong tích hợp Pushwoosh
        tenjin_analytics_installation_id:
          type: string
          nullable: true
          description: ID thiết bị của người dùng trong tích hợp Tenjin
    ErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              source:
                type: string
                nullable: true
                description: Nguồn gốc lỗi
              errors:
                type: array
                items:
                  type: string
                description: Mảng thông báo lỗi
        error_code:
          type: string
          description: Tên lỗi rút gọn
        status_code:
          type: integer
          description: Mã trạng thái HTTP
      required:
        - errors
        - error_code
        - status_code
  securitySchemes:
    apikeyAuth:
      type: apiKey
      name: Authorization
      in: header
      default: Api-Key {Your secret API key}
      description: |
        Các yêu cầu API phải được xác thực bằng secret API key của bạn trong header **Authorization**
        với giá trị `Api-Key {your_secret_api_key}`, ví dụ:
        `Api-Key secret_live_...`. Tìm key này trong Adapty Dashboard ->
        **App Settings** -> tab **General** -> phần **API keys**.
```