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

# 캠페인 상세 조회



## OpenAPI

````yaml /api_docs/openapi-ko.yaml get /v1/server/campaigns/{id}
openapi: 3.0.3
info:
  title: PlayCamp SDK API
  description: |
    PlayCamp SDK API - 게임 분석 및 크리에이터 캠페인 연동 API

    ## 필수 연동 API (Server API)
    캠페인 진행을 위해 반드시 연동해야 하는 API 3개:
    - `POST /v1/server/sponsors` - 유저가 크리에이터를 부스트
    - `POST /v1/server/coupons/validate` - 쿠폰 코드 유효성 검사
    - `POST /v1/server/payments` - 인게임 결제 등록

    ## 인증 방식
    - **Client API**: `Authorization: Bearer {CLIENT_KEY_ID}:{CLIENT_SECRET}`
    - **Server API**: `Authorization: Bearer {SERVER_KEY_ID}:{SERVER_SECRET}`

    ## 서버
    - **Live**: https://sdk-api.playcamp.io (실제 데이터)
    - **Sandbox**: https://sandbox-sdk-api.playcamp.io (테스트 데이터)

    ## 키 타입
    - **Client 키**: 게임 클라이언트용 (읽기 전용 - 캠페인, 크리에이터 조회)
    - **Server 키**: 게임 서버용 (읽기/쓰기 - 쿠폰 사용, 결제 등록 등)

    ## 테스트 모드 (isTest)
    캠페인 실행 전에 `isTest: true` 파라미터를 사용하여 API 연동을 테스트할 수 있습니다.
    - 요청 파라미터 검증은 실제와 동일하게 수행
    - 모의 데이터를 반환하며 실제 DB에 기록되지 않음
    - 캠페인 시작 전 Sandbox 환경에서 연동 검증 후, 실제 캠페인 시 `isTest` 파라미터 제거
  version: 1.1.0
  contact:
    name: PlayCamp Support
servers:
  - url: https://sdk-api.playcamp.io
    description: Live Server
  - url: https://sandbox-sdk-api.playcamp.io
    description: Sandbox Server
  - url: http://localhost:3001
    description: Local Live Server
  - url: http://localhost:3003
    description: Local Sandbox Server
security: []
tags:
  - name: Health
    description: 서버 상태 확인
  - name: Client Campaign
    description: 캠페인 조회 (Client API)
  - name: Client Creator
    description: 크리에이터 조회 (Client API)
  - name: Client Coupon
    description: 쿠폰 유효성 검사 (Client API)
  - name: Client Sponsor
    description: 부스트 상태 조회 — Sponsor API (Client API)
  - name: Server Campaign
    description: 캠페인 조회 (Server API)
  - name: Server Creator
    description: 크리에이터 조회 (Server API)
  - name: Server Coupon
    description: 쿠폰 관리 (Server API)
  - name: Server Sponsor
    description: 부스트 관리 — Sponsor API (Server API)
  - name: Server Payment
    description: 결제 관리 (Server API)
  - name: Server Playtime
    description: 플레이타임 세션 관리 (Server API)
  - name: Server Webhook
    description: 웹훅 관리 (Server API)
  - name: Server Webview
    description: WebView 관리 (Server API)
paths:
  /v1/server/campaigns/{id}:
    get:
      tags:
        - Server Campaign
      summary: 캠페인 상세 조회
      operationId: serverGetCampaign
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: 성공
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/Campaign'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
        - ServerAuth: []
components:
  schemas:
    Campaign:
      type: object
      properties:
        campaignId:
          type: string
        projectId:
          type: string
        campaignName:
          type: object
          description: '다국어 캠페인 이름 (예: {"ko": "캠페인명", "en": "Campaign Name"})'
          additionalProperties:
            type: string
        description:
          type: object
          description: 다국어 설명
          additionalProperties:
            type: string
        startDate:
          type: string
          format: date-time
          nullable: true
        endDate:
          type: string
          format: date-time
          nullable: true
        status:
          type: string
          enum:
            - PENDING_EXPOSURE
            - EXPOSED
            - IN_PROGRESS
            - COMPLETED
            - CANCELLED
    Error:
      type: object
      required:
        - status
        - error
        - message
        - code
      properties:
        status:
          type: integer
          description: HTTP 상태 코드
        error:
          type: string
          description: HTTP 상태 이름
        message:
          type: string
          description: 상세 에러 메시지
        code:
          type: string
          description: |
            에러 코드:
            - `VALIDATION_ERROR`: 요청 파라미터 검증 실패
            - `BAD_REQUEST`: 잘못된 요청
            - `UNAUTHORIZED`: 인증 실패 (API 키 오류)
            - `FORBIDDEN`: 권한 없음
            - `NOT_FOUND`: 리소스를 찾을 수 없음
            - `CONFLICT`: 중복 리소스 (이미 존재)
            - `INTERNAL_ERROR`: 서버 내부 오류
        details:
          type: array
          description: 검증 오류 상세 (VALIDATION_ERROR의 경우)
          items:
            type: object
            properties:
              path:
                type: string
              message:
                type: string
      example:
        status: 404
        error: Not Found
        message: 'Payment not found: txn-12345'
        code: NOT_FOUND
  responses:
    NotFound:
      description: 리소스를 찾을 수 없음
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            status: 404
            error: Not Found
            message: Resource not found
            code: NOT_FOUND
  securitySchemes:
    ServerAuth:
      type: http
      scheme: bearer
      description: 'Server API Key (format: {keyId}:{secret})'

````