{"id":212012,"date":"2020-08-10T16:05:50","date_gmt":"2020-08-10T14:05:50","guid":{"rendered":"http:\/\/sycszpz.cluster100.hosting.ovh.net\/api-sms-http\/api-documentation\/"},"modified":"2025-09-08T09:01:18","modified_gmt":"2025-09-08T07:01:18","slug":"api-documentation","status":"publish","type":"page","link":"https:\/\/www.textinghouse.com\/en\/api-sms-http\/api-documentation\/","title":{"rendered":"API documentation"},"content":{"rendered":"

[et_pb_section fb_built=”1″ inner_shadow=”on” custom_padding_last_edited=”on|phone” _builder_version=”4.16″ background_image=”https:\/\/www.textinghouse.com\/wp-content\/uploads\/2017\/11\/bg_api_sms.jpg” background_position=”top_left” custom_padding=”0px||29px||false|false” custom_padding_tablet=”” custom_padding_phone=”||30px|” locked=”off” global_colors_info=”{}”][et_pb_row column_structure=”2_3,1_3″ custom_padding_last_edited=”on|phone” _builder_version=”4.19.4″ background_size=”initial” background_position=”top_left” background_repeat=”repeat” custom_padding=”0px|0px|0px|0px|false|false” custom_padding_tablet=”” custom_padding_phone=”0px|||” global_colors_info=”{}”][et_pb_column type=”2_3″ _builder_version=”4.16″ custom_padding=”|||” global_colors_info=”{}” custom_padding__hover=”|||”][et_pb_text _builder_version=”4.16″ global_colors_info=”{}”]<\/p>\n

API SMS PRO Documentation<\/span><\/h1>\n

[\/et_pb_text][\/et_pb_column][et_pb_column type=”1_3″ _builder_version=”4.16″ custom_padding=”|||” global_colors_info=”{}” custom_padding__hover=”|||”][et_pb_button button_url=”https:\/\/api.textinghouse.com\/” button_text=”Test API” button_alignment=”center” disabled_on=”on|off|off” _builder_version=”4.16″ custom_button=”on” button_text_color=”#ffffff” button_bg_color=”#ffa200″ button_border_width=”0″ button_letter_spacing=”1″ button_font=”|on|||” button_icon=”5||divi||400″ button_rel=”off||on||” custom_margin=”0px||0px|” custom_margin_tablet=”70px|||” saved_tabs=”all” global_colors_info=”{}” button_text_size__hover_enabled=”off” button_one_text_size__hover_enabled=”off” button_two_text_size__hover_enabled=”off” button_text_color__hover_enabled=”off” button_one_text_color__hover_enabled=”off” button_two_text_color__hover_enabled=”off” button_border_width__hover_enabled=”off” button_one_border_width__hover_enabled=”off” button_two_border_width__hover_enabled=”off” button_border_color__hover_enabled=”off” button_one_border_color__hover_enabled=”off” button_two_border_color__hover_enabled=”off” button_border_radius__hover_enabled=”off” button_one_border_radius__hover_enabled=”off” button_two_border_radius__hover_enabled=”off” button_letter_spacing__hover_enabled=”off” button_one_letter_spacing__hover_enabled=”off” button_two_letter_spacing__hover_enabled=”off” button_bg_color__hover_enabled=”off” button_one_bg_color__hover_enabled=”off” button_two_bg_color__hover_enabled=”off”][\/et_pb_button][et_pb_text _builder_version=”4.16″ text_font=”||||||||” text_orientation=”center” global_colors_info=”{}”]<\/p>\n

If you have a specific need, contact us<\/a>!<\/span><\/strong><\/span><\/p>\n

[\/et_pb_text][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ specialty=”on” _builder_version=”4.20.2″ custom_margin=”15px|||||” custom_padding=”0px|||||” global_colors_info=”{}”][et_pb_column type=”1_4″ _builder_version=”4.16″ custom_padding=”|||” global_colors_info=”{}” custom_padding__hover=”|||”]<\/p>\n

[et_pb_sidebar area=”et_pb_widget_area_8″ disabled_on=”on|on|off” admin_label=”Barre lat\u00e9rale” module_id=”doc-menu” _builder_version=”4.20.2″ global_colors_info=”{}”][\/et_pb_sidebar]<\/p>\n

[\/et_pb_column][et_pb_column type=”3_4″ specialty_columns=”3″ _builder_version=”4.16″ custom_padding=”|||” global_colors_info=”{}” custom_padding__hover=”|||”][et_pb_row_inner module_id=”doc-text” _builder_version=”4.16″ custom_padding=”||29px|||” locked=”off” global_colors_info=”{}”][et_pb_column_inner saved_specialty_column_type=”3_4″ _builder_version=”4.16″ global_colors_info=”{}”][et_pb_text _builder_version=”4.17.4″ _module_preset=”default” global_colors_info=”{}”]<\/p>\n

Versions<\/h2>\n

<\/p>\n\n\n\n\n\n\n\n
Num<\/th>\nModifications<\/th>\nDate of application<\/th>\n<\/tr>\n<\/thead>\n
1.0.0<\/td>\nInitial version<\/td>\n\u00a0<\/td>\n<\/tr>\n
1.1.0<\/td>\n\n
    \n
  • Commercial messages must include the words ‘STOP sms-s.top’.<\/li>\n
  • Error code added : 400 – STOP mention missing<\/li>\n<\/ul>\n<\/td>\n
16\/12\/2021<\/td>\n<\/tr>\n
1.1.1<\/td>\n\n11\/07\/2022<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

[\/et_pb_text][et_pb_text module_id=”doc-intro” _builder_version=”4.16″ global_colors_info=”{}”]<\/p>\n

1. Introduction<\/h2>\n

<\/p>\n

The HTTP API is the easiest way<\/strong> to use TextingHouse’s SMS communication portal. This interface can be used in the form of HTTP POST<\/strong> as well as GET<\/strong> URL. We recommend using POST if the data volume is large, as the GET is limited in size. TextingHouse’s responses to these queries are plain text (content-type: text\/plain; charset=utf-8<\/strong>). For example the ID of the SMS created, the SMS status code, the credit value, an error code… They are inserted directly into the HTTP body of the response<\/strong>, without any particular tag. Communication with our API is done over HTTPS<\/strong> on port 443. Note<\/strong>: It is important that the entire document is read before contacting support. All of the examples shown in this document use HTTP GET.<\/p>\n

[\/et_pb_text][et_pb_text module_id=”doc-prerequis” _builder_version=”4.16″ global_colors_info=”{}”]<\/p>\n

2. Prerequisites<\/h2>\n

<\/p>\n

In order to use the SMS sending API you first need an active customer account<\/strong> with positive credit<\/strong> on the TextingHouse systems. The identifiers will be replaced by ‘XXXX<\/em>‘ in the code examples that follow. To register, it’s here: Register – API TextingHouse<\/a>.<\/p>\n

[\/et_pb_text][et_pb_text module_id=”doc-exemple” _builder_version=”4.16″ global_colors_info=”{}”]<\/p>\n

3. Examples<\/h2>\n

<\/p>\n

Below are basic implementation examples for sending an SMS via the TextingHouse API. The parameters are case sensitive<\/strong>.<\/p>\n

[\/et_pb_text][et_pb_accordion _builder_version=”4.27.4″ _module_preset=”default” global_colors_info=”{}”][et_pb_accordion_item title=”GET basic command example” open=”on” _builder_version=”4.16″ _module_preset=”default” global_colors_info=”{}”]<\/p>\n

GET:<\/strong><\/p>\n

<\/p>\n

https:\/\/api.textinghouse.com\/http\/v1\/do?user=XXXX&pass=XXXX&cmd=sendsms&to=999&txt=XXXXX&iscom=N<\/code><\/pre>\n
<\/p>\n
Return example:<\/strong><\/p>\n
<\/p>\n
ID:5d726149a129c829e8c23f7b<\/code><\/pre>\n
[\/et_pb_accordion_item][et_pb_accordion_item title=”Javascript Node.js example – axios” _builder_version=”4.27.4″ _module_preset=”default” global_colors_info=”{}” open=”off”]<\/p>\n
axios<\/a>:<\/strong><\/p>\n
<\/p>\n
const axios = require('axios');    \r\n\r\naxios({\r\n  method: 'post',\r\n  url: 'https:\/\/api.textinghouse.com\/http\/v1\/do',\r\n  data: {\r\n    user: 'XXXX',\r\n    pass: 'XXXX',\r\n    cmd: 'sendsms',\r\n    to: '999',\r\n    txt: 'My test SMS',\r\n    iscom: 'N'\r\n  },\r\n  responseType: 'text'\r\n})\r\n.then((res) => {\r\n  console.log(res.data)\r\n})\r\n.catch((error) => {\r\n  console.error(error)\r\n});<\/code><\/pre>\n
[\/et_pb_accordion_item][et_pb_accordion_item title=”PHP example – cURL” _builder_version=”4.16″ _module_preset=”default” global_colors_info=”{}” open=”off”]<\/p>\n
cURL<\/a>:<\/strong><\/p>\n
<\/p>\n
$data = array(\r\n    'user' => 'XXXX',\r\n    'pass' => 'XXXX',\r\n    'cmd' => 'sendsms',\r\n    'to' => '999',\r\n    'txt' => 'My test SMS',\r\n    'iscom' => 'N'\r\n);\r\n$url = 'https:\/\/api.textinghouse.com\/http\/v1\/do';\r\n$ch = curl_init($url);\r\n$postString = http_build_query($data, '', '&');\r\ncurl_setopt($ch, CURLOPT_POST, 1);\r\ncurl_setopt($ch, CURLOPT_POSTFIELDS, $postString);\r\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\r\n$response = curl_exec($ch);\r\ncurl_close($ch);<\/code><\/pre>\n
[\/et_pb_accordion_item][\/et_pb_accordion][et_pb_text module_id=”doc-fonctionnement” _builder_version=”4.16″ global_colors_info=”{}”]<\/p>\n
4. How the API works<\/h2>\n
[\/et_pb_text][et_pb_text module_id=”doc-auth” _builder_version=”4.16″ global_colors_info=”{}”]<\/p>\n
4.1 Authentication<\/h3>\n
<\/p>\n
Once your account is created on TextingHouse API<\/a>, your login details are available on the “Options” page:<\/p>\n
<\/p>\n