API v4 문의사항

카카오모먼트 API
1

아래 내용을 기재하신 후 문의를 남겨주시길 바랍니다. .
호출 시 발생한 오류의 경우 호출 /응답 내용을 상세히 남겨주시는 것이 확인 및 답변에 도움이 됩니다.

  • 사업자명: 플레이디
  • APP 이름(ID):
  • 문의 내용:

안녕하세요. @momentOPENAPI

  1. 광고 계정 목록 보기 관련 문의
    모든 광고계정 목록을 보는건데 특정 광고계정 ID를 어떻게 알고 호출 할 수 있는건가요?
    광고계정목록 보기할때는 Header에 adAccountId가 필요없는지요

  1. 광고계정보기 아래 두가지 호출 방법중 후자가 맞는지요
    curl -X GET “https://apis.moment.kakao.com/openapi/v4/adAccounts/{adAccountId}”
    -H “Authorization: Bearer {ACCESS_TOKEN}”
    -H “adAccountId: {adAccountId}”

    아래 두가지 방법에는 모두 헤더에 adAccountId 값을 넣었습니다.

    아래와 같이 예제로 호출을 해보면 400 Bad Request가 나옵니다. (예제)
    https://apis.moment.kakao.com/openapi/v4/adAccounts/12555

    url 뒤에 {adAccountId} 이부분을 빼고 호출하면 정상적으로 됩니다.
    https://apis.moment.kakao.com/openapi/v4/adAccounts

    표기상 REST API 식으로 표기는 했지만, Header에 포함시키는게 맞는건지요.

  2. 레거시 API v1,v2,v3 은 언제까지 유지되나요?

  3. 보고서 API 호출시 허용된 호출회수 초과시 메시지에는 “허용된 API 요청을 초과하였습니다.” 라고 나옵니다, (code 값 -813) HTTP 상태코드는 429인데, HTTP상태코드가 429인건 포즈 API 초당 요청 한도를 초과한 경우라고 문서상 명시되어있습니다.
    하지만 받은 코드 값은 -815인데, 어떤게 맞는지도 답변 부탁드립니다.

감사합니다.

2

안녕하세요
모먼트 오픈 API 담당자입니다.

문의 주신 부분에 대해서 답변드립니다.

  1. 광고계정 목록 보기 관련 문의
    Header에 요청하신 계정으로 조회를 하는것이 아니기 때문에 특정 광고계정 ID를 알고 요청하실 필요는 없습니다.
    다만, Header로 adAccountId를 받는것이 모먼트 OPEN API 의 정책이기 때문에 플레이디에서 사용하고 계신 광고계정 중에
    선택하시어 요청하시면 됩니다.

  2. 광고계정 보고 두 가지 호출 방법중 맞는것은
    문의를 주셔서 저희가 확인해 봤는데 https://apis.moment.kakao.com/openapi/v4/adAccounts/12555 로 요청주실때
    Header 에 adAccountId를 다른 adAccountId를 설정하신게 아닐까 합니다.

  3. 레거시 API v1, v2, v3 종료시점
    v1의 경우는 금주나 다음주중으로 공식적으로 공지가 나갈 예정입니다.
    v1의 경우 내년 2월 중으로 종료가 예정되어 있습니다.
    v2, v3의 경우는 내년 상반기 안으로 종료를 진행할 예정입니다.

  4. 보고서 API RateLimit (허용된 API 요청 초과) 문의
    code값이 -813이 맞는데 -185를 받으신 것 같아요
    이 부분은 좀더 확인이 필요할 것 같은데 혹시 요청하셨을 때 받으신 exception 전문을 캡쳐로 올려봐주실 수 있으실까요?

3

안녕하세요.
1,2,3 에 관련 답변 감사드립니다.

4번 문의내용 다시 말씀드립니다.

아래 이미지는 response 입니다.
kakaomoment_response

위 이미지와 같이 code 값이 -813으로 받고, HTTP 상태코드 429로 받습니다.

kakaomoment_statuscodePNG

HTTP 상태 코드 값을 보면, 코드 값이 -813일때는 카카오모먼트 API의 내부에러로, HTTP 상태코드 400으로 되어있거든요,
HTTP 상태코드만 봤을때는 포즈 API 초당 요청 한도를 초과한 경우라고 되어있어서 문의드렸던 내용입니다.

코드 값 -813 / 카카오모먼트 API의 내부 에러 / HTTP 상태코드 429 > 허용된 API 요청 초과 로 인지하면 될까요.
API 레퍼런스상에는 명시가 되어있지 않아 문의드립니다.

감사합니다.

4

안녕하세요
모먼트 오픈 API 담당자입니다.

4번은 가이드가 누락되었습니다.
혼란스러우셨을텐데 죄송합니다.

첨부해주신 캡쳐 이미지처럼
모먼트 OPEN API 의 경우 RateLimit(허용된 API 요청 횟수)가 초과된 경우
HttpStatus는 429, errorCode는 -813이 맞습니다.

가이드는 빠르게 수정하도록 하겠습니다.
감사합니다.