---
updatedAt: 2025-03-17T08:41:55.000Z
agentTools:
  projectIndex: https://sdk.sendon.io/llms.txt
---

# 단가 및 포인트 조회

<Image align="center" src="https://files.readme.io/513ce9663634696b9d67712754ec2fdcff928eed73d88030cafac9e3cb75a645-point.png" />

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

<br />

## 잔여 포인트 조회

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

### Node.js 예제

```coffeescript typescript
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();

```
```java java
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 은 다음과 같은 형태입니다.

```json
{
  "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"
        }
      }
    ]
  }
}
```

<br />

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

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

<br />

🔗 **[SDK Point 잔여포인트 조회](https://sdk.sendon.io/recipes/sdk-point-%EC%9E%94%EC%97%AC%ED%8F%AC%EC%9D%B8%ED%8A%B8-%EC%A1%B0%ED%9A%8C#/)**

<br />

## 단가 조회

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

### Node.js 예제

```coffeescript typescript
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();

```
```java java
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();
  }
}
```

<br />

🔗 **[SDK Point 단가 조회](https://sdk.sendon.io/recipes/sdk-point-%EB%8B%A8%EA%B0%80-%EC%A1%B0%ED%9A%8C#/)**

<br />

## 사용 시 주의사항

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