페이지 이동경로
  • 문서>
  • 카카오 키워드광고>
  • 심사서류 관리

카카오 키워드광고

심사서류 관리

이 문서는 심사서류 관리 API 사용 방법을 안내합니다.

이 API를 통해 비즈채널과 소재 심사에 필요한 서류를 관리할 수 있습니다.

심사서류 목록 보기

기본 정보

GET /openapi/v1/documents HTTP/1.1
Host: api.keywordad.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}

심사서류 정보를 조회합니다.

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 GET으로 요청합니다. 성공 시 응답 바디에 JSON 객체로 종류별 심사서류 관리 상세 정보를 받습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

Request

Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer ${ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
bizChannelId Long 비즈채널 ID O

Response

Name Type Description
bizChannelId Long 비즈채널 ID
bizChannelName String 웹사이트명
documents ReviewDocument 심사서류 정보

Sample

Request
curl -X GET "https://api.keywordad.kakao.com/openapi/v1/documents?bizChannelId=2222222221" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Response
HTTP/1.1 200 OK
Content-type: application/json;charset=UTF-8
{
  "bizChannelId": "2222222221",
  "bizChannelName": "비즈채널_변경이력1",
  "documents": [
    {
      "id": "9999999991",
      "fileName": "test.jpg",
      "requiredDocumentId": 92,
      "requiredDocumentName": "의료광고심의필증",
      "type": "CREATIVE",
      "url": "https://www.kakao.com/document1.jpg"
    },
    {
      "id": "9999999991",
      "fileName": "test.jpg",
      "requiredDocumentId": 93,
      "requiredDocumentName": "기타서류",
      "type": "CREATIVE",
      "url": "https://www.kakao.com/document2.jpg"
    }
  ]
}

심사서류 등록하기

기본 정보

POST /openapi/v1/documents HTTP/1.1
Host: api.keywordad.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}

새로운 심사서류를 등록합니다.

심사서류 등록을 위해 application/jsonmultipart/form-data 두 가지 Content-Type을 지원합니다. 어느 방식으로 요청하더라도 등록 결과는 같습니다.

  • application/json: fileUrl 파라미터로 https:// 또는 https:// URL 형식의 심사서류 경로 전달
  • multipart/form-data: file 파라미터로 로컬 파일 경로 전달

액세스 토큰(Access token)과 광고계정 ID(adAccountId)를 헤더에 담아 POST로 요청합니다. 요청이 성공하면 응답 바디에 JSON 객체로 생성된 심사서류 정보를 받습니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.

Request

Header
Name Type Description Required
Authorization String 액세스 토큰
Bearer ${ACCESS_TOKEN} 형식으로 전달
O
adAccountId Long 광고계정 ID O
Parameter
Name Type Description Required
bizChannelId Long 비즈채널 ID O
type String 심사서류 타입
CREATIVE: 소재 심사서류
BIZ_CHANNEL: 비즈채널 심사서류
O
requiredDocumentId RequiredDocument 심사서류 ID O
fileUrl String http:// 또는 https:// 형식의 URL형태로 요청
최대 파일글자수: 255자
최대 용량: 10MB
지원하는 파일형식: JPG, JPEG, GIF, PNG, TIF, HWP, DOC, DOCX, PDF
O*
file Multipart File 로컬 파일 경로 입력
최대 용량: 10MB
지원하는 파일형식: JPG, JPEG, GIF, PNG, TIF, HWP, DOC, DOCX, PDF
O*

* application/json 방식일 경우 fileUrl 필수, multipart/form-data 방식일 경우 file 필수

Sample

Request: application/json 방식
curl -X POST "https://api.keywordad.kakao.com/openapi/v1/documents" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
    -H "Content-Type: application/json" \
    -d '{
            "bizChannelId": "2222222221",
            "requiredDocumentId": 93,
            "type": "CREATIVE",
            "fileUrl":"https://www.image.com/document1.png"
        }'
Request: multipart/form-data 방식
curl -X POST "https://api.keywordad.kakao.com/openapi/v1/documents" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
    -H "Content-Type: multipart/form-data" \
    -F "bizChannelId=2222222221" \
    -F "type=CREATIVE" \
    -F "requiredDocumentId=93" \
    -F "file=@파일_경로" 
Response
HTTP/1.1 200 OK
Content-Length: 0
Content-type: application/json;charset=UTF-8

더보기

카카오 키워드광고> 심사서류 관리