API

Ta sekcja to dokumentacja techniczna integracji naszej usługi wysyłania SMS-ów z twoją aplikacją / witryną Aby uzyskać niezbędny token do korzystania z interfejsu API, musisz utworzyć konto.

Wysyłanie SMS-ów

Aby wysłać lub zaplanować wiadomość SMS, musisz zrobić zapytanie za pomocą metody POST w celu adresu: https://www.smsadvert.ro/api/sms/ wpisz application/json

Przykład wysyłania wiadomości SMS za pośrednictwem smsadvert.ro sieci

Dostawa SMS-a odbywa się natychmiast po złożeniu zapytania.

var axios = require('axios');
var data = JSON.stringify({
  phone: '+40740123456',
  shortTextMessage: 'This is the content of the SMS message',
  sendAsShort: true
});

var config = {
  method: 'post',
  url: 'https://www.smsadvert.ro/api/sms/',
  headers: {
    Authorization: 'API_AUTH_TOKEN',
    'Content-Type': 'application/json'
  },
  data: data
};

axios(config)
  .then(function(response) {
    console.log(JSON.stringify(response.data));
  })
  .catch(function(error) {
    console.log(error);
  });

Przykład wysyłania wiadomości SMS za pomocą własnych urządzeń

Dostawa SMS-a odbywa się natychmiast po złożeniu zapytania.

POST https://www.smsadvert.ro/api/sms/ HTTP/1.1
Authorization: API_AUTH_TOKEN
Content-Type: application/json

{
  "phone": "+40740123456",
  "shortTextMessage": "To jest treść wiadomości SMS"
}

Przykład wysyłania wiadomości SMS za pomocą własnych urządzeń z przełączaniem awaryjnym

Jeśli nie masz żadnych podłączonych urządzeń lub operator GSM odpowie komunikatem o błędzie, wiadomość SMS zostanie wysłana za pośrednictwem smsadvert.ro sieci

POST https://www.smsadvert.ro/api/sms/ HTTP/1.1
Authorization: API_AUTH_TOKEN
Content-Type: application/json

{
  "phone": "+40740123456",
  "shortTextMessage": "To jest treść wiadomości SMS",
  "failover": "short"
}

Przykład wysyłania harmonogramu SMS

Dostawa SMS odbywa się zgodnie z parametrami startDate i endDate.

POST https://www.smsadvert.ro/api/sms/ HTTP/1.1
Authorization: API_AUTH_TOKEN
Content-Type: application/json

{
  "phone": "+40740123456",
  "shortTextMessage": "To jest treść wiadomości SMS",
  "startDate": 1486883578036,
  "endDate": 1486889778036
}

Przykładowe wysyłanie wiadomości SMS z wieloma adresatami

Dostarczenie wiadomości SMS do adresatów odbywa się pojedynczo, natychmiast po złożeniu wniosku.

POST https://www.smsadvert.ro/api/sms/ HTTP/1.1
Authorization: API_AUTH_TOKEN
Content-Type: application/json

{
  "phone": "+40740123456,+40740123457,+40740123458",
  "shortTextMessage": "To jest treść wiadomości SMS"
}

Przykład wysłania wiadomości SMS z oddzwonieniem do raportu dostawy

Dostawa SMS-a odbywa się natychmiast po złożeniu zapytania. Otrzymasz wówczas żądanie na adres z parametru callback z raportem dostawy.

POST https://www.smsadvert.ro/api/sms/ HTTP/1.1
Authorization: API_AUTH_TOKEN
Content-Type: application/json

{
  "phone": "+40740123456",
  "shortTextMessage": "To jest treść wiadomości SMS",
  "callback": "http://twojastrona.com/callback-url/"
}

Opis parametrów

  • phone

    string, obowiązkowy
  • Reprezentuje numer telefonu odbiorcy.
    Numer musi być w formacie międzynarodowym E.164 (np .: +40740123456)

    W przypadku wielu odbiorców można wprowadzić numery telefonów oddzielone przecinkami, np. „+40740123456,+40740123457”.
    Maksymalnie 1000 numerów telefonów i numery, które są duplikatami, nie będą rejestrowane do przesłania.
    Uwaga! Przecinek nie jest akceptowany na końcu listy.
  • shortTextMessage

    string, obowiązkowy
  • Reprezentuje treść wiadomości SMS i musi składać się z co najmniej 3 i maksymalnie 480 znaków.
  • sendAsShort

    boolean, opcjonalny
  • Aby wysłać SMS przez sieć smsadvert.ro, parametr ten musi zawierać wartość true. W przypadku, gdy ten parametr ma wartość false lub nie jest obecny, wiadomość zostanie wysłana przez twoje urządzenia.
  • startDate

    integer, opcjonalny
  • Reprezentuje datę / godzinę / minutę / sekundę, po której rozpocznie się wysyłanie wiadomości. Format to czas UNIX (milisekundy).
  • endDate

    integer, opcjonalny
  • Reprezentuje datę / godzinę / minutę / sekundę, po której wysyłanie wiadomości zostanie zatrzymane. Format to czas UNIX (milisekundy).
  • failover

    string, opcjonalny
  • Reprezentuje dodatkowy kanał wysyłający.
    Jeśli wiadomość nie może zostać dostarczona przez twoje urządzenia (nie ma co najmniej jednego podłączonego urządzenia lub operator GSM odpowiada komunikatem o błędzie), próba wysłania zostanie podjęta przez drugi kanał.

    Jeśli parametr failover jest ustawiony na „short”, wtedy SMS zostanie wysłany przez smsadvert.ro sieć.
  • callback

    string, opcjonalny
  • Reprezentuje adres internetowy (URL), na który otrzymasz żądanie zawierające status dostarczenia wiadomości.

    Żądanie będzie typu POST (application/json) i będzie zawierało dwa parametry: status o wartości „delivered” lub „failed” i msgId reprezentujące identyfikator otrzymanej wiadomości w odpowiedzi na żądanie wysyłania.

    Przykład żądania, które otrzymasz na swój adres zwrotny

    POST http://twojastrona.com/callback-url/ HTTP/1.1
    Content-Type: application/json
    
    {
      "status": "delivered",
      "msgId": "xxxxxx"
    }
    

Odpowiedź

Odpowiedź otrzymana przez żądanie jest typu application/json.

Przykład udanej odpowiedzi

Content-Type: application/json

{
  "successMessage": "Your message has been successfully submitted!",
  "msgId": "xxxxxx"
}

Przykłady odpowiedzi na błąd

Content-Type: application/json

{
  "errors": {
    "phone": "Nieprawidłowy numer telefonu!",
    "shortTextMessage": "Wpisz minimum 3 znaków!"
  }
}
Content-Type: application/json

{
  "errorMessage": "There was a database error!"
}