세 번의 움직임, 전달 시작
모든 통합은 동일한 짧은 아크(인증, 전송, 추적)입니다.
요청할 때마다 Content-Type: application/json을 사용하여 액세스 키를 토큰 헤더로 보냅니다.
from, to 및 콘텐츠를 게시합니다. 응답은 msgid 및 오류 코드와 함께 즉시 반환됩니다.
메시지가 최종 상태에 도달하는 순간 우리는 콜백 URL에 상태 보고서를 게시하거나 GET합니다.
이미 사용하고 있는 언어로 한 번의 요청
토큰 헤더를 사용하여 보낸 사람, 받는 사람 및 콘텐츠를 게시하세요. 응답은 우리가 받아들이는 순간 다시 돌아옵니다.
01curl -X POST https://secure.smslocal.com/api/service/enterprise-service/external/sms \02 -H "Token: $SMSLOCAL_TOKEN" \03 -H "Content-Type: application/json" \04 -d '{05 "from": "SMSLOCAL",06 "to": "14155550123",07 "content": "Your code is 481920."08 }'msgid "9f2a7c10-4b2e-…"
방향 "산"
오류 코드 0
저장 msgid — 여기에서 이 메시지를 추적하는 방법입니다.
메시지를 위에서 아래로 읽기
보내기, 상태 및 수신 이벤트는 모두 동일한 형태를 반환합니다. 한 번 알아보세요.
메시지 ID
msgid — 메시지가 생성되는 순간 생성됩니다. 나중에 상태를 확인하는 데 사용하는 핸들입니다.
보내는 사람
from — 전화번호 또는 최대 11자의 영숫자 ID 중 수신자가 볼 수 있는 신원입니다.
받는 사람
to — 국가 코드를 포함하여 메시지가 전달될 번호입니다.
부호화
데이터코딩 — GSM7은 부품당 160자에 적합합니다. 유니코드로 전환하면 70으로 떨어집니다. 그러면 추가 청구 부분으로 연결됩니다.
방향
방향 — 모든 메시지는 mt(당신이 보낸 것) 또는 mo(당신이 받은 것)입니다. 어느 쪽이든 같은 모양입니다.
오류 코드
errorcode — 전송 응답 및 모든 상태 보고서에 반환됩니다. 0은 승인됨을 의미합니다. 다른 것들은 정확히 무엇이 잘못되었는지 알려줍니다.
하나의 끝점, 두 개의 동사
전송하려면 POST, 상태를 확인하려면 GET — 어느 쪽이든 동일한 URL과 동일한 토큰 헤더입니다.
보내다
메시지를 보내고 msgid와 오류 코드를 즉시 받아보세요.
보고 msgid + 오류코드길
이미 보낸 메시지를 찾아 현재 상태를 확인하세요.
보고 메시지 + 상태상태 보고, 발생하는 순간
콜백 URL을 설정하면 모든 배달, 실패 및 인바운드 응답이 GET 또는 POST로 전달됩니다. 폴링이 필요하지 않습니다.
개발자 문서 - 자주 묻는 질문
모든 요청의 토큰 헤더에 액세스 키(토큰: {accessKey})를 Content-Type: application/json과 함께 전달합니다.
모든 전송은 msgid를 반환합니다. 콜백 URL을 알려주시면 메시지가 최종 상태(subdate, donedate 및 결과 상태 코드 포함)에 도달하는 순간 상태 보고서를 게시하거나 GET합니다.
mt(모바일 종료)는 귀하가 보낸 메시지입니다. mo(모바일에서 전송됨)는 귀하가 받은 답변입니다. 둘 다 동일한 메시지 개체 모양을 사용합니다.
재시도 정책에 따라 배달이 재시도됩니다. 자동으로 삭제되는 것은 없지만 승인하지 않는 엔드포인트는 계속해서 재시도를 수신합니다.
GSM7 인코딩에서는 160자, 유니코드에서는 70자입니다. 한도를 초과하면 메시지가 여러 부분으로 연결되고 각각 별도로 요금이 청구됩니다.