Run with Postman
Documentation Powered by Redocly

Messaggi SMS (1.0.0)

URL: https://openapi.it/en/support Terms of Service

la documentazione qui presentata descrive tuttee le principali funzionalità e le istruzioni per gestire le rubriche e l'invio di messaggi multipli o singoli dai siti messaggisms (invio di SMS a numeri italiani +39) e textmessage pro (invio di SMS a numeri inglesi +44).
Dopo essersi iscritti ad uno dei siti è possibile recuperare i dati di autenticazione da Impostazioni > Api e Developers

Term of services messaggisms
Term of services textmessage.pro

First time here? Generate a new access token

Varie

Utility generiche

Stato dell'utente

Restituisce dati relativi all'utente

Authorizations:
sms_auth

    Responses

    Response Schema: application/json
    success
    boolean
    code
    number
    object

    Request samples 

    CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://software.messaggisms.com/api//user_status");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Basic REPLACE_BASIC_AUTH");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

    Response samples

    Content type
    application/json
    "{\n success: true,\n code: 200,\n data: [\n \"credit\": \"8\",\n \"history\": [\n {\n \"date\": \"2019-04-12 09:57:03\",\n \"payment_type\": null,\n \"user_generated\": true,\n \"currency\": null,\n \"price\": null,\n \"formatted_price\": null,\n \"operation\": \"First registration\",\n \"description\": \"First subscription to TextMessage by the user\"\n },\n ]\n ]\n}"

    Lista dei mittenti

    Restituisce la lista dei mittenti registrati

    Authorizations:
    sms_auth

      Responses

      Response Schema: application/json
      success
      boolean
      code
      number
      Array of objects[ items ]

      Request samples 

      CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://software.messaggisms.com/api//senders");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Basic REPLACE_BASIC_AUTH");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

      Response samples

      Content type
      application/json
      "{\n success: true,\n code: 200,\n data: [\n {\n \"id_sender\": \"123456\",\n \"phone_number\": \"333123456789\",\n \"name\": \"ALTRAVIA\"\n }\n ]\n}"

      Versione delle API

      la versione delle API

      Authorizations:
      sms_auth

        Responses

        Request samples 

        CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://software.messaggisms.com/api//api_version");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Basic REPLACE_BASIC_AUTH");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

        Response samples

        Content type
        application/json
        "{\n success: true,\n code: 200,\n data: [\n {\n \"version\": \"1.0\"\n }\n ]\n}"

        Contacts

        Gestione rubriche e contatti

        Aggiunge un nuovo numero in rubrica

        Aggiunge un nuovo numero in rubrica

        Authorizations:
        sms_auth
          Request Body schema: application/json
          addressbooks
          Array of strings 2 items

          Lista delle rubriche dove aggiungere il contatto

          disable_update
          boolean
          Default: "<boolean>"

          Se passato a true non aggiorna eventuali dati duplicati

          create_addressbook_if_not_exist
          boolean
          Default: "<boolean>"

          se passato a true aggiunge una rubrica nel caso in cui la rubrica non sia esistente

          object

          Responses

          Response Schema: application/json
          success
          boolean
          code
          number
          object

          Request samples

          Content type
          application/json
          {
          • "addressbooks": [
            ],
          • "disable_update": "<boolean>",
          • "create_addressbook_if_not_exist": "<boolean>",
          • "contact_data": {
            }
          }

          Response samples

          Content type
          application/json
          "{\n \"success\": true,\n \"code\": 200,\n \"data\": {\n \"created_contact\": 1,\n \"updated_contact\": 0\n }\n}"

          Dettagli di un contatto

          Restituisce i dettagli di un contatto a partire dal numero di telefono

          Authorizations:
          sms_auth
            path Parameters
            phone
            required
            string
            Default: "<string>"

            Il numero di telefono

            Responses

            Response Schema: application/json
            success
            boolean
            code
            number
            object (ContactDetail)

            Request samples 

            CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://software.messaggisms.com/api//contact/%7Bphone%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Basic REPLACE_BASIC_AUTH");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

            Response samples

            Content type
            application/json
            "{\n \"success\": true,\n \"data\": {\n \"name\": \"Giuseppe\",\n \"last_name\": \"Rossio\",\n \"email\": \"\",\n \"phone\": \"3923456789\",\n \"birthday_date\": \"\",\n \"sex\": null,\n \"company_name\": \"\",\n \"address\": \"\",\n \"zip_code\": \"\",\n \"city\": \"\",\n \"region\": \"\",\n \"custom_field1\": \"\",\n \"custom_field2\": \"\",\n \"custom_field3\": \"\",\n \"custom_field4\": \"\",\n \"last_reading_date\": null,\n \"last_iteration_date\": null,\n \"last_click_date\": null,\n \"addressbooks\": [\n \"Default\",\n \"test\",\n \"rubrica prova lista\"\n ]\n },\n \"code\": 200\n}"

            Eliminazione di un contatto

            Elimina un contatto a partire dal numero di telefono

            Authorizations:
            sms_auth
              path Parameters
              phone
              required
              string
              Default: "<string>"

              Il numero di telefono

              Responses

              Request samples 

              CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_easy_setopt(hnd, CURLOPT_URL, "https://software.messaggisms.com/api//contact/%7Bphone%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Basic REPLACE_BASIC_AUTH");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

              Response samples

              Content type
              application/json
              "{\n \"success\": true,\n \"code\": 200\n}"

              Lista delle rubriche

              Restituisce la lista delle rubriche

              Authorizations:
              sms_auth

                Responses