Kakao

채널 목록 조회

Changed on

등록된 채널들의 목록을 페이징 방식으로 조회합니다. 알림톡과 브랜드메시지 발송에 사용할 수 있는 채널들을 확인할 수 있습니다.

get/v2/messages/kakao/send-profiles

Request

  • Base URL
    https://api.sendon.io
  • URL
    https://api.sendon.io/v2/messages/kakao/send-profiles
  • Auth
    HTTP basic

Query parameters

cursorstring
Example:1234567890

페이징을 위한 커서 값입니다. 다음 페이지를 요청할 때 이전 응답에서 받은 cursor 값을 사용하세요.

limitnumber nullable
Example:10

한 번에 조회할 채널의 최대 개수입니다. 기본값은 20개이며, 너무 큰 값을 설정하면 응답 속도가 느려질 수 있습니다.

Response

채널 목록 조회 요청의 처리 결과입니다. 등록된 채널들의 정보와 페이징 정보가 포함됩니다.

codenumber required

HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.

messagestring required

API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.

Example response

{
  "code": 200,
  "message": "OK",
  "data": {
    "sendProfiles": [
      {
        "id": "profile_12345",
        "channelId": "example_channel",
        "channelName": "센드온 공식 채널",
        "status": "ACTIVE",
        "profileStatus": "ACTIVATED",
        "updatedBy": "admin@example.com",
        "updatedAt": "2024-01-15T10:30:00Z",
        "createdAt": "2024-01-01T09:00:00Z"
      }
    ],
    "nextCursor": "cursor_next_12345"
  }
}

Changes

    • breaking

      the response's property type changed from object to no type for status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • info

      api operation id getSendProfiles removed and replaced with ProfileController_getSendProfiles

    • info

      the endpoint scheme security basic was added to the API

    • info

      added to the response property allOf list for the response status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response's property default value 200 was removed for the status

    • info

      the response's property default value 성공 was removed for the status