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

# Verify the user token

> 인증 토큰을 확인하고 사용자를 로그인합니다. 사용자는 이메일로 검증 토큰을 받아야 합니다.



## OpenAPI

````yaml /openapi/adm.openapi.ko-0.2.2.json post /auth/verify
openapi: 3.1.0
info:
  description: >-
    ## 소개

    Data Management API는 광고 및 추천 시스템이 활용하는 **다양한 데이터를** 종합적으로 관리해, Decision API가
    정확하고 효율적으로 작동할 수 있도록 돕습니다.


    캠페인이나 지면을 신규 등록하고 수정·삭제하는 것은 물론, **로그 및 통계 분석을** 통해 시스템 운영에 필요한 인사이트를 확보합니다.
    이렇게 확보된 데이터와 통계는 Decision API에서 최적화된 광고·콘텐츠를 결정하는 데 활용되며, 전체 광고·추천 시스템의 성능
    향상에 이바지합니다.
  title: Data Management APIs
  version: 0.1.3
servers: []
security: []
tags:
  - name: Audience Targeting
  - description: >
      오디언스 관리 API를 사용하여 오디언스 관련 데이터를 통합할 수 있습니다.


      참고:

      - [First-Party
      Data](https://docs.aiderx.io/guides/about-a2/en/first-party-data)
    name: Audience
  - description: >
      광고 타겟팅 및 성과 최적화를 위한 사용자 활동 로그 수집 API.


      활동 로그는 광고 상호작용 여부와 관계없이 모든 사용자의 상품 조회, 검색, 장바구니 추가, 구매 등 실제 사용자 행동을 기록합니다.


      참고:

      - [First-Party
      Data](https://docs.aiderx.io/guides/about-a2/en/first-party-data)
    name: Activity Log
  - description: >
      오디언스 속성 API로 오디언스 속성 데이터에 액세스할 수 있습니다.


      참고:

      - [Audience
      Targeting](https://docs.aiderx.io/guides/about-a2/en/audience-targeting)
    name: Audience Attribute
  - description: >
      오디언스 세그먼트 API로 오디언스 세그먼트 데이터에 액세스할 수 있습니다.


      참고:

      - [Audience
      Targeting](https://docs.aiderx.io/guides/about-a2/en/audience-targeting)
    name: Audience Segment
  - description: >
      광고 타겟팅 및 성과 최적화를 위한 사용자 활동 로그 수집 API.


      활동 로그는 광고 상호작용 여부와 관계없이 모든 사용자의 상품 조회, 검색, 장바구니 추가, 구매 등 실제 사용자 행동을 기록합니다.


      참고:

      - [First-Party
      Data](https://docs.aiderx.io/guides/about-a2/en/first-party-data)
    name: Activity Log
  - description: >
      오디언스 속성 API로 오디언스 속성 데이터에 액세스할 수 있습니다.


      참고:

      - [Audience
      Targeting](https://docs.aiderx.io/guides/about-a2/en/audience-targeting)
    name: Audience Attribute
  - description: >
      오디언스 세그먼트 API로 오디언스 세그먼트 데이터에 액세스할 수 있습니다.


      참고:

      - [Audience
      Targeting](https://docs.aiderx.io/guides/about-a2/en/audience-targeting)
    name: Audience Segment
  - description: 분석 API는 대시보드 및 A2 메트릭 데이터에 액세스할 수 있습니다.
    name: Analytic
  - description: >-
      결제 정보를 관리하는 결제 API입니다.

      A2는 리테일 플랫폼에서 사용하는 결제 시스템과 통합되도록 구성되어 있습니다.


      결제를 통합하려면 먼저 외부 채널을 등록해야 합니다.

      결제 시스템과 통합하는 방법에 대한 자세한 내용은 [외부 채널
      페이지](https://docs.aiderx.io/guides/about-a2/en/external-channel)를 참고하세요.
    name: Billing
  - description: |
      캠페인 데이터를 관리하는 캠페인 API입니다.

      관련 문서:
      - [Campaign](https://docs.aiderx.io/guides/about-a2/en/campaign)
    name: Campaign
  - description: |
      소재 및 관련 리소스를 관리하는 크리에이티브 API입니다.

      관련 문서:
      - [Creative](https://docs.aiderx.io/guides/about-a2/en/creative)
    name: Creative
  - description: |
      배정 및 관련 리소스를 관리하는 할당 API입니다.

      관련 문서:
      - [Allocation](https://docs.aiderx.io/guides/about-a2/en/allocation)
    name: Allocation
  - description: |
      미디어 라이브러리 및 관련 리소스를 관리하는 미디어 라이브러리 API입니다.

      관련 문서:
      - [Media Library](https://docs.aiderx.io/guides/about-a2/en/media-library)
    name: Media Library
  - description: |
      소재 및 관련 리소스를 관리하는 크리에이티브 API입니다.

      관련 문서:
      - [Creative](https://docs.aiderx.io/guides/about-a2/en/creative)
    name: Creative
  - description: |
      배정 및 관련 리소스를 관리하는 할당 API입니다.

      관련 문서:
      - [Allocation](https://docs.aiderx.io/guides/about-a2/en/allocation)
    name: Allocation
  - description: |
      미디어 라이브러리 및 관련 리소스를 관리하는 미디어 라이브러리 API입니다.

      관련 문서:
      - [Media Library](https://docs.aiderx.io/guides/about-a2/en/media-library)
    name: Media Library
  - description: >
      카탈로그 관리 API는 카탈로그 및 관련 리소스를 관리하는 기능을 제공합니다.


      관련 문서:

      - [First-Party
      Data](https://docs.aiderx.io/guides/about-a2/en/first-party-data)
    name: Catalog
  - description: |
      지면 관리 API는 지면 및 관련 리소스를 관리하는 기능을 제공합니다.

      관련 문서:
      - [Placement](https://docs.aiderx.io/guides/about-a2/en/placement)
    name: Placement
  - description: |
      지면 카탈로그는 지면 정보를 구조화된 “광고 제품”으로 변환하여 광고주에게 쉽게 제시할 수 있습니다.

      관련 문서:
      - 업데이트 예정
    name: Placement Catalog
  - description: |
      지면 카탈로그는 지면 정보를 구조화된 “광고 제품”으로 변환하여 광고주에게 쉽게 제시할 수 있습니다.

      관련 문서:
      - 업데이트 예정
    name: Placement Catalog
  - description: >
      시스템 레벨 설정 및 자산(로고 및 구성 값)에 액세스하고 관리할 수 있는 시스템 API입니다.


      관련 문서:

      - [Yield Optimization
      Settings](https://docs.aiderx.io/guides/about-a2/en/yield-optimization)
    name: System
  - description: >
      인증 및 사용자 관리 기능을 제공합니다.


      관련 문서:

      - [Account and
      Budget](https://docs.aiderx.io/guides/about-a2/en/account-and-budget)
    name: Auth and User
  - description: 라이선스 관리 기능을 제공합니다.
    name: License
  - description: 라이선스 관리 기능을 제공합니다.
    name: License
paths:
  /auth/verify:
    post:
      tags:
        - Auth and User
      summary: Verify the user token
      description: 인증 토큰을 확인하고 사용자를 로그인합니다. 사용자는 이메일로 검증 토큰을 받아야 합니다.
      operationId: verify_verify_auth_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Body_verify_verify_auth_verify_post'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserRead'
          description: Successful Response
        '400':
          content:
            application/json:
              examples:
                VERIFY_USER_ALREADY_VERIFIED:
                  summary: The user is already verified.
                  value:
                    detail: VERIFY_USER_ALREADY_VERIFIED
                VERIFY_USER_BAD_TOKEN:
                  summary: >-
                    Bad token, not existing user ornot the e-mail currently set
                    for the user.
                  value:
                    detail: VERIFY_USER_BAD_TOKEN
              schema:
                $ref: '#/components/schemas/HTTPExceptionResponse'
          description: Bad Request
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    Body_verify_verify_auth_verify_post:
      properties:
        token:
          title: Token
          type: string
      required:
        - token
      title: Body_verify_verify_auth_verify_post
      type: object
    UserRead:
      description: 유저 스키마
      properties:
        budget:
          description: 사용자가 현재 이용 가능한 전체 예산
          title: Budget
          type: number
        campaign_count:
          description: 사용자가 소유한 캠페인 수
          minimum: 0
          title: Campaign Count
          type: integer
        creative_count:
          description: 사용자가 소유한 소재 수
          minimum: 0
          title: Creative Count
          type: integer
        credit:
          description: 사용자가 현재 이용 가능한 전체 크레딧
          title: Credit
          type: number
        email:
          description: 유저 이메일
          format: email
          title: Email
          type: string
        id:
          description: 유저 id
          format: uuid
          title: Id
          type: string
        is_active:
          description: 사용자 활성 상태 여부
          title: Is Active
          type: boolean
        is_superuser:
          description: 사용자 관리자 여부
          title: Is Superuser
          type: boolean
        is_verified:
          description: 사용자 이메일 인증 여부
          title: Is Verified
          type: boolean
        name:
          anyOf:
            - type: string
            - type: 'null'
          description: 사용자 이름
          title: Name
        permissions:
          description: 사용자의 권한 정보
          examples:
            - {}
            - admin: []
              advertiser:
                - permission
              analytic:
                - campaign
              audience: []
              audience_attribute:
                - r
              audience_segment:
                - r
                - w
              campaign:
                - r
                - w
              creative:
                - r
                - w
              placement:
                - r
              retailer: []
            - admin:
                - list_advertisers
                - budget
              advertiser: []
              analytic:
                - placement
              audience:
                - r
              audience_attribute:
                - r
                - w
              audience_segment:
                - r
                - w
              campaign:
                - r
              creative:
                - r
                - w
              placement:
                - r
                - w
              retailer:
                - approval
                - permission
          title: Permissions
          type: object
        placement_count:
          description: 사용자가 소유한 지면 수
          minimum: 0
          title: Placement Count
          type: integer
        preferences:
          anyOf:
            - $ref: '#/components/schemas/UserPreferences'
            - type: 'null'
        role:
          $ref: '#/components/schemas/UserRole'
      required:
        - id
        - email
        - is_active
        - is_superuser
        - is_verified
        - role
        - permissions
        - budget
        - credit
        - preferences
        - campaign_count
        - creative_count
        - placement_count
      title: UserRead
      type: object
    HTTPExceptionResponse:
      description: HTTP 오류 응답
      properties:
        detail:
          description: 오류에 대한 상세 설명
          title: Detail
          type: string
      required:
        - detail
      title: HTTPExceptionResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    UserPreferences:
      description: 사용자 설정 정보
      properties:
        etc:
          description: 추가 사용자 설정
          examples:
            - language: ko
          title: Etc
          type: object
        notification_methods:
          additionalProperties:
            type: boolean
          description: 허용된 알림 수신 방식
          examples:
            - email: true
              slack: false
              sms: false
          propertyNames:
            $ref: '#/components/schemas/NotificationMethod'
          title: Notification Methods
          type: object
        notification_methods_data:
          additionalProperties:
            type: string
          description: 알림 수신 방식에 사용되는 데이터
          examples:
            - slack: <SLACK_WEBHOOK_URL>
              sms: ''
          propertyNames:
            $ref: '#/components/schemas/NotificationMethod'
          title: Notification Methods Data
          type: object
        notifications:
          additionalProperties:
            type: boolean
          description: 허용된 알림 이벤트 타입
          examples:
            - attribute_deleted: true
              campaign_finished: true
              publish_approval: true
              publish_request: true
          propertyNames:
            $ref: '#/components/schemas/NotificationEvent'
          title: Notifications
          type: object
      required:
        - notification_methods
        - notification_methods_data
        - notifications
        - etc
      title: UserPreferences
      type: object
    UserRole:
      description: 유저 역할
      enum:
        - advertiser
        - retailer
        - admin
      title: UserRole
      type: string
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object

````