Küsi kohaletoimetamisraportit | QuantumTec API teatmik

POST-päring

POST-päring
Parameeter	Kirjeldus
`messageId`stringvalikuline	Sõnumi ID. Selle puudumisel tagastatakse saadaolevad kohaletoimetamisraportid.
`Limit`integervalikuline	Tagastatavate raportite suurim arv. Vaikimisi: 50. Maksimum: 500.

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",
  "Limit": 50
}'

Vastus

Vastus on raportite massiiv. Seosta SMS-i osad partId järgi ja loe iga osa tulemust väljast state. state 2 tähendab Delivered ehk kohale toimetatud.

Vastus
Parameeter	Kirjeldus
`messageId`string	Sõnumi identifikaator.
`to`number	Saaja number avaldatud vastuse näites.
`partId`string	SMS-i osa identifikaator.
`state`integer	Kohaletoimetamise olek, 2–8.
`delivered`string	Kohaletoimetamisraporti saamise aeg UTC järgi.
`errorCode`string	Operaatori veakood; kõik operaatorid seda ei toeta.

[
  {
    "messageId": "19905880-9404-4686-a8af-54af8888b96d",
    "to": 37250000000,
    "partId": "300000005",
    "state": 2,
    "delivered": "2026-09-01T10:00:02.000Z",
    "errorCode": "000"
  }
]

GET-variant

GET edastab samad messageId ja Limit parameetrid koos X-ApiKey väärtusega URL-i päringuosas. Raporti struktuur on sama.

curl --get 'https://api.quantumtec.eu/v1/sms/report' \
  --header 'Accept: application/json' \
  --data-urlencode 'X-ApiKey=YOUR_API_KEY' \
  --data-urlencode 'messageId=19905880-9404-4686-a8af-54af8888b96d' \
  --data-urlencode 'Limit=50'