메뉴

API: 광고주로서 퍼블리셔 관리하기(기술 가이드)

오퍼를 관리하려면 Mintegral 토큰을 사용해야 합니다. 자세한 내용은 Token을 확인하세요.

이 가이드는 광고주가 오퍼에서 퍼블리셔("mtgid"라고도 함)를 관리하는 방법을 안내합니다. 이 기능은 고급 기능이므로 “permission denied” 메시지가 반환되면 계정 담당 팀에 문의하여 접근 권한을 요청하세요.

도움이 필요하면 계정 매니저에게 문의하거나, 미국 외 지역은 growth@mintegral.com, 미국은 growth.us@mintegral.com으로 이메일을 보내세요.

요청 주소

https://ss-api.mintegral.com/api/open/v1/offer/target

요청 메서드

PUT

요청 예시

json Copy

PUT /api/open/v1/offer/target
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{ 
  "offer_id": 1234, 
  "option": "ENABLE", 
  "mtgid":  "mtg1127838375" 
}

요청 파라미터

Fields	Type	Explanations	Default Value	Examples
offer_id	int	오퍼 ID	—	`1234`
option	string	오퍼 내 퍼블리셔 상태입니다. 열거 값: `"ENABLE"`, `"DISABLE"`, `"ALLOW_ALL"` `ENABLE`: 특정 mtgid를 차단 목록에서 제거합니다. `DISABLE`: 특정 mtgid를 차단 목록에 추가합니다. `ALLOW_ALL`: 모든 mtgid를 차단 목록에서 제거합니다.	—	`"DISABLE"`
mtgid	string	상태를 설정할 mtgid입니다. option이 `"ALLOW_ALL"`로 설정된 경우에만 mtgid를 null로 설정할 수 있으며, null로 설정하면 모든 차단 목록 설정이 제거됩니다. 여러 mtgid는 쉼표로 구분하며 최대 3000개까지 가능합니다. 참고: 이 API는 전체 업데이트 방식을 사용하므로 전체 설정을 제출하세요.	—	`"mtg1127838375"`

응답

Fields	Type	Explanations
code	int	200이면 성공입니다. 그 외 코드는 실패를 의미합니다.
msg	string	성공 시 "success"를 반환합니다. 실패 시 상세 오류 정보를 반환합니다.
data	json	성공 시 null을 반환합니다. 실패 시 상세 오류 정보를 반환합니다.

응답 예시

json Copy

{
  "msg": "success",
  "code": 200,
  "data": null
}

이전의

API: 오퍼 프로모션 상태 업데이트하기

API: 트래킹 URL 업데이트하기(기술 가이드)

최근 수정됨: 2026-08-06

개요