SMS 인코딩 및 세그먼트 수 계산

실제로 보낼 메시지 텍스트 분석

전송하려는 텍스트의 인코딩, 인코딩된 길이 및 SMS 세그먼트 수를 계산합니다. 이 엔드포인트는 SMS를 전송하거나 경로를 예약하거나 전송 요금 견적을 반환하지 않습니다. 전송 워크플로에서 추가하는 바닥글, 링크 또는 수신 거부 문구를 모두 포함한 최종 텍스트 전체를 제출하세요.

요청

활성화된 API 계정과 해당 계정에 허용된 출발지 IP 주소를 사용하여 인증하세요. 인증 정보는 서버 측 비밀 저장소에 보관하세요. UTF-8 문자열을 text 필드에 담아 전송하세요. 예시에서는 환경 변수를 사용합니다.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode 'text=Your message here' \
  https://api.multitel.net/v3/smslength

폼 인코딩 입력을 지원합니다. 다음 예시와 같은 JSON 객체({"text":"Your message here"})도 폼 필드나 쿼리 필드가 제공되지 않은 경우 허용됩니다. 메시지 텍스트가 URL에 나타나지 않도록 POST 사용을 권장합니다. 폼 입력과 쿼리 입력이 모두 있으면 폼 입력을 사용합니다. 요청 형식을 혼용하지 마세요.

응답

{
  "status": {
    "code": "200",
    "msg": ""
  },
  "response": {
    "charset": 0,
    "encoding": "GSM-7",
    "count": 1,
    "parts": 1,
    "chars": 17,
    "units": 17,
    "single_limit": 160,
    "multipart_limit": 153
  }
}

계산 결과 필드
필드	의미
charset	0은 GSM-7을, 2는 UTF-16을 나타냅니다.
encoding	GSM-7 또는 UTF-16.
parts, count	계산된 SMS 세그먼트 수를 나타내는 두 필드명입니다. 텍스트가 비어 있으면 두 값 모두 영입니다.
units, chars	인코딩된 단위 수를 나타내는 두 필드명입니다. 이 값이 화면에 보이는 문자 수와 반드시 일치하는 것은 아닙니다.
single_limit	선택한 인코딩에서 단일 세그먼트에 허용되는 인코딩 단위 수의 한도입니다.
multipart_limit	세그먼트 연결에 필요한 오버헤드를 제외한 뒤 각 세그먼트에 적용되는 인코딩 단위 수의 한도입니다.

인코딩 및 세그먼트 한도

계산기에 적용되는 한도
인코딩	단일 세그먼트	여러 세그먼트로 나눌 때의 세그먼트당 한도
GSM-7	160셉텟	153셉텟
UTF-16	70코드 단위	67코드 단위

GSM-7 확장 문자인 ^, 중괄호, 대괄호, 역슬래시, 세로줄, 물결표 및 유로 기호 등은 각각 두 셉텟을 사용합니다. GSM-7에 포함되지 않는 문자가 있으면 메시지 전체를 UTF-16 기준으로 계산합니다. 기본 다국어 평면 밖의 이모지는 두 UTF-16 단위를 사용하며, 화면에 하나로 보이는 이모지 시퀀스에도 여러 코드 포인트가 포함될 수 있습니다.

예를 들어 일반 문자 160개를 GSM-7으로 인코딩하면 세그먼트 하나에 들어가지만 161개는 두 개가 필요합니다. ^ 문자 여든 개는 160단위를 사용하여 세그먼트 하나에 들어가지만, 여든한 개는 162단위를 사용하여 두 개가 필요합니다. 기본 다국어 평면 밖의 단순 이모지 서른다섯 개는 70 UTF-16 단위를 사용하여 세그먼트 하나에 들어가지만, 서른여섯 개는 72단위를 사용하여 두 개가 필요합니다. 결합 문자와 연결된 이모지에 따라 이 수치는 달라질 수 있습니다.

오류 및 빈 텍스트

text 필드가 없거나, 스칼라 값 대신 배열 또는 객체를 제공하거나, 유효하지 않은 UTF-8을 제공하면 API 코드 403을 반환합니다. HTTP 상태뿐 아니라 JSON의 status.code 및 status.msg도 확인하세요. 이 엔드포인트는 코드를 문자열로 반환합니다. 빈 문자열은 유효하며 단위 수와 세그먼트 수 모두 영을 반환합니다.

전송 전에 결과 활용

검토된 계산기에는 메시지 전송, 통신사 호출 또는 계정 잔액 차감 기능이 없습니다. 계산 결과는 제출된 텍스트에 대한 분석이며, 전달을 보장하거나 최종 청구 금액을 나타내지 않습니다. 전송 시 수신 대상별 요금, 통신사 수수료, 캠페인 요건 및 추가 텍스트 변환이 적용될 수 있습니다. 메시지를 변경한 후에는 다시 계산하고, 승인된 전송 워크플로와 현재 계정 요금을 사용하세요.