ISCloudSMS API — SMS client

00Prezentare

API-ul client ISCloudSMS oferă trei operațiuni esențiale pentru trimiterea de mesaje SMS tranzacționale și de notificare:

Toate răspunsurile sunt JSON și conțin câmpurile errorCode, errorName și errorMessage. errorCode = 0 înseamnă succes.

01Base URL

Toate rutele sunt prefixate cu /ISCloudSMS.

https://smsgateway.eservicii.md/ISCloudSMS

02Autentificare

Autentificarea se face cu o cheie API de tip UUID, emisă per companie. Cheia se transmite în query (la cererile GET) sau direct în corpul JSON (la POST SendSMS).

# în query
?apiKey=6061a897-0693-4686-be25-6abe73d85c08

# în corpul JSON
{ "apiKey": "6061a897-0693-4686-be25-6abe73d85c08", ... }

03Quick start

Trimiterea unui SMS în câteva secunde:

curl -X POST https://smsgateway.eservicii.md/ISCloudSMS/SendSMS \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "6061a897-0693-4686-be25-6abe73d85c08",
    "number": "+37360000000",
    "message": "..."
  }'

04Trimitere SMS

{
                        "errorCode": 0,
                        "errorName": "NoError",
                        "errorMessage": null,
                        "uid": "f3b2c1a0-…",   // identificatorul SMS-ului în sistem
                        "smsQuantity": 1,        // nr. de segmente
                        "smSparts": 1,
                        "rejectedPhones": []     // completat dacă numărul a fost respins
}

{
                        "errorCode": 116,
                        "errorName": "Company_alias_is_not_correct",
                        "rejectedPhones": [ { "number": "+37360000000", "id": "ORD-10231" } ]
}

05Status SMS

GET /ISCloudSMS/StatusSMS?apiKey=6061a897-…&id=ORD-10231

{ "errorCode": 0, "state": 1 }   // state = stare SMS (vezi referință)

06Sumar lunar

GET /ISCloudSMS/MonthlySummary?apiKey=6061a897-…&year=2026&month=5

{
                        "errorCode": 0,
                        "items": [
    { "companyShortName": "MyDiscount", "count": 1240 }
  ]
}

07Callback-uri (notificări de stare)

Dacă specifici callBackURI la SendSMS, sistemul îți apelează URL-ul (asincron) când starea SMS-ului se schimbă. Codul stării este atașat URL-ului în unul din două moduri:

# cu placeholder
https://exemplu.md/sms/callback?status={status}  →  ...?status=8
                                                 →  ...?status=1

# fără placeholder
https://exemplu.md/sms/callback?status=  →  ...?status=8

Sunt acceptate doar URL-uri absolute http / https.

08Stările unui SMS

Câmpul state (din StatusSMS și din callback) este un cod întreg. Stările posibile:

09Tipuri de mesaj (notificationType)

Câmpul opțional notificationType din SendSMS spune ce fel de mesaj trimiți. Implicit 0. Tipul nu schimbă tariful, dar schimbă prioritatea în coadă și durata de valabilitate:

Ca privilegiul acesta să nu fie folosit pentru a sări coada, un mesaj declarat ValidationCode este verificat la trimitere și respins cu Invalid_parameter (105) dacă:

# acceptat
{ "notificationType": 3, "message": "Codul dvs. este 123456" }

# respins — Invalid_parameter
{ "notificationType": 3, "message": "Reducere 50%! Detalii pe site" }

10Coduri de eroare

Fiecare răspuns conține errorCode (număr), errorName și errorMessage. 0 = succes. Codurile relevante pentru endpoint-urile client: