단가 및 포인트 조회

센드온 SDK는 사용자의 잔여 포인트와 단가 정보를 간편하게 조회할 수 있는 기능을 제공합니다. 이 섹션에서는 포인트 및 단가 조회 방법과 예제를 다룹니다.

잔여 포인트 조회

잔여 포인트를 조회하여 사용 가능한 포인트를 확인할 수 있습니다.

Node.js 예제

import { Sendon } from '@alipeople/sendon-sdk-typescript'
import { PointsListResponseDto } from '@alipeople/sendon-sdk-typescript';

const sendon = new Sendon({ id: "YOUR_ID", apikey: "YOUR_APIKEY" })

const result: PointsListResponseDto = await sendon.point.listPoints();

import io.sendon.Sendon;
import io.sendon.model.SendMessageRequestDto;
import io.sendon.model.SendMessageRequestDtoToInner;

class Example {
  public static void main(String argv[]) {
    
		Sendon sendon = Sendon.getInstance("YOUR_ID", "YOUR_APIKEY");
    
    PointsListResponseDto response = sendon.getPoint().listPoints();
  }
}

PointsListResponseDto 은 다음과 같은 형태입니다.

{
  "code": 200,
  "message": "OK",
  "data": {
    "points": [
      {
        "general": {
          "userId": 43,
          "pointId": 12,
          "costId": 24,
          "points": 57831310.69,
          "channelId": 0,
          "createdAt": "2024-11-04T01:56:50.000Z"
        }
      }
    ]
  }
}

아래는 주요 필드에 대한 설명입니다.

필드	설명	필수여부
pointId	포인트 고유ID	O
costId	단가 고유ID	O
points	잔여 포인트	O
channelId	채널 고유ID

🔗 SDK Point 잔여포인트 조회

단가 조회

사용자의 메시지 단가 정보를 조회할 수 있습니다.

Node.js 예제

import { Sendon } from '@alipeople/sendon-sdk-typescript'
import { CostGetResponseDto } from '@alipeople/sendon-sdk-typescript';

const sendon = new Sendon({ id: "YOUR_ID", apikey: "YOUR_APIKEY" })

const result: CostGetResponseDto = await sendon.point.getCost();

import io.sendon.Sendon;
import io.sendon.model.SendMessageRequestDto;
import io.sendon.model.SendMessageRequestDtoToInner;

class Example {
  public static void main(String argv[]) {
    
		Sendon sendon = Sendon.getInstance("YOUR_ID", "YOUR_APIKEY");
    
    CostGetResponseDto response = sendon.getPoint().getCost();
  }
}

🔗 SDK Point 단가 조회

사용 시 주의사항

정확한 API 호출: 잔여 포인트 및 단가 조회 API를 호출하기 전에 인증 정보를 정확히 설정해야 합니다.
응답 데이터 활용: 반환된 데이터에서 필요한 정보를 추출하여 대시보드 또는 알림 시스템에 활용하세요.
에러 처리: 네트워크 오류나 인증 실패 등 예외 상황을 처리하여 사용자 경험을 개선하세요.