Liigu lehe sisu juurde

Kiirjuhend

Saada esimene SMS API v1 kaudu ja kontrolli selle kohaletoimetamist.

Enne alustamist

  1. Hangi API võti kliendiportaalist või küsi seda oma kliendihaldurilt.
  2. Asenda YOUR_API_KEY oma võtmega, INFO oma saatja nime või numbriga (Sender ID) ning näite telefoninumber saaja numbriga koos riigikoodiga.

Kontrolli saldot

Vastus loetleb saldod valuutade kaupa: amount on summa ja currency valuutakood.

cURL · GET
curl --get 'https://api.quantumtec.eu/v1/Common/balance' \
  --header 'Accept: application/json' \
  --data-urlencode 'X-ApiKey=YOUR_API_KEY'
JSON-vastus
[
  {
    "amount": 392.5,
    "currency": "EUR"
  }
]

Saada SMS

Tee päring oma andmetega. Salvesta vastusest messageId: seda läheb vaja kohaletoimetamise kontrollimiseks.

cURL · POST
curl --request POST 'https://api.quantumtec.eu/v1/sms/single' \
  --header 'X-ApiKey: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
  "to": "37250000000",
  "from": "INFO",
  "text": "Test message"
}'
JSON-vastus
{
  "messageId": "19905880-9404-4686-a8af-54af8888b96d",
  "sent": "2026-09-01T10:00:01.000Z",
  "partIds": [
    "300000005"
  ]
}

Kontrolli kohaletoimetamist

Asenda allolev messageId oma saatmispäringu vastusest saadud ID-ga. Raport tagastab iga SMS-i osa kohaletoimetamise oleku.

cURL · POST
curl --request POST 'https://api.quantumtec.eu/v1/sms/report' \
  --header 'X-ApiKey: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
  "messageId": "19905880-9404-4686-a8af-54af8888b96d"
}'
JSON-vastus
[
  {
    "messageId": "19905880-9404-4686-a8af-54af8888b96d",
    "to": 37250000000,
    "partId": "300000005",
    "state": 2,
    "delivered": "2026-09-01T10:00:02.000Z",
    "errorCode": "000"
  }
]