콘텐츠로 이동
EasterAdEasterAdDocs

하우스 캠페인 목록

GET
/api/core/organization/{organizationId}/house-campaign
curl --request GET \
  --url https://www.easterad.com/api/core/organization/example/house-campaign \
  --header 'Authorization: Bearer <token>'

Authorizations

섹션 제목: “Authorizations”

Parameters

섹션 제목: “Parameters”

Path Parameters

섹션 제목: “Path Parameters”
organizationId
required
string

Responses

섹션 제목: “Responses”

200

섹션 제목: “200”

성공

Media typeapplication/json
Array<object>
object
campaign
required
object
advertiser
required
string
_id
required
string
status
required
Any of:
string
Allowed value: CAMPAIGN_STATUS_PENDING
budgetRemain
required
number
name
required
string
>= 1 characters <= 40 characters
startAt
required
string
/^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$/
endAt
string
/^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$/
cur
required
Any of:
string
Allowed value: CURRENCY_KRW
budget
required
number
targeting
required
object
platforms
required
Array
devices
required
Array
tags
required
Array<string>
locations
required
Array<string>
languages
required
Array<string>
inventoryTargets
required
Array
Any of:
object
organizationId
required
string
/^[0-9a-fA-F]{24}$/
btags
required
Array<string>
ads
required
Array<object>
object
_id
required
string
cur
required
Any of:
string
Allowed value: CURRENCY_KRW
name
required
string
>= 1 characters <= 40 characters
categories
required
Array<string>
cpm
number
productType
required
Any of:
string
Allowed value: AD_PRODUCT_TYPE_INTRINSIC
creatives
required
Array
>= 1 items
Any of:
object
_id
required
string
image
required
object
width
required
number
>= 1
height
required
number
>= 1
mime
required
string
>= 1 characters <= 20 characters
aspectRatio
required
number
> 0
url
required
string
/^https?://(?:[^\s/:?#]+|\[[0-9A-Fa-f:.]+\])(?::\d{1,5})?(?:[/?#][^\s]*)?$/
destinationUrl
string
/^https?://(?:[^\s/:?#]+|\[[0-9A-Fa-f:.]+\])(?::\d{1,5})?(?:[/?#][^\s]*)?$/
promotedAppId
string
/^[0-9a-fA-F]{24}$/
createdAt
required
string
/^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$/
updatedAt
required
string
/^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\.[0-9]{1,9})?(?:Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$/
servingEligibility
required
object
status
required
Any of:
string
Allowed value: HOUSE_CAMPAIGN_SERVING_ELIGIBILITY_STATUS_ELIGIBLE
issues
required
Array<object>
object
reason
required
Any of:
string
Allowed value: HOUSE_CAMPAIGN_SERVING_ISSUE_REASON_APP_OWNERSHIP_MISMATCH
inventoryTarget
required
Any of:
object
organizationId
required
string
/^[0-9a-fA-F]{24}$/
productType
Any of:
string
Allowed value: AD_PRODUCT_TYPE_INTRINSIC
crossPromotionId
string
/^[0-9a-fA-F]{24}$/
promotedAppId
string
/^[0-9a-fA-F]{24}$/
Example
[
  {
    "campaign": {
      "status": "CAMPAIGN_STATUS_PENDING",
      "cur": "CURRENCY_KRW",
      "targeting": {
        "platforms": [
          "APP_PLATFORM_ANDROID"
        ],
        "devices": [
          "DEVICE_TYPE_MOBILE_TABLET"
        ]
      },
      "ads": [
        {
          "cur": "CURRENCY_KRW",
          "productType": "AD_PRODUCT_TYPE_INTRINSIC"
        }
      ]
    },
    "servingEligibility": {
      "status": "HOUSE_CAMPAIGN_SERVING_ELIGIBILITY_STATUS_ELIGIBLE",
      "issues": [
        {
          "reason": "HOUSE_CAMPAIGN_SERVING_ISSUE_REASON_APP_OWNERSHIP_MISMATCH",
          "productType": "AD_PRODUCT_TYPE_INTRINSIC"
        }
      ]
    }
  }
]

default

섹션 제목: “default”

오류 — 공통 오류 응답. 인증 단계 오류 코드는 문서의 “인증” 페이지를 참조.

Media typeapplication/json
object
statusCode
required
number
code
required

BadRequest | Unauthorized | Forbidden | NotFound | Conflict | TooManyRequests | InternalServerError | ServiceUnavailable

string
message
required
string
reason

선택 상세 사유. 예: CREATIVE_NOT_READY

string
assetId

관련 소재 ID (선택)

string
Examplegenerated
{
  "statusCode": 1,
  "code": "example",
  "message": "example",
  "reason": "example",
  "assetId": "example"
}