İleti Merkezi SMS API

https://www.toplusmsapi.com
Admin
İleti Merkezi provides a robust SMS API for integrating bulk, single, or OTP SMS sending...
Tokens:58,799
Snippets:327
Trust Score:6.7
Update:11 months ago
Show doc for...
Tokens:
Raw
### XML Post API Request Example

Source: https://www.toplusmsapi.com/sms/baslik/liste/xml

Complete example of an XML POST request with sample credentials. Demonstrates proper XML formatting with version declaration and UTF-8 encoding. Uses demo credentials for authentication (key and hash fields).

```xml
<?xml version="1.0" encoding="UTF-8" ?>
<request>
  <authentication>
    <key>demo</key>
    <hash>demo</hash>
  </authentication>
</request>
```

--------------------------------

### Example Error API Response (XML)

Source: https://www.toplusmsapi.com/hesap/bakiye/xml

An example of an erroneous response from the get-balance API. This specific example shows a '401' status code, indicating that the provided 'Üyelik bilgileri hatalı' (Membership information is incorrect), likely due to invalid authentication credentials.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>401</code>
    <message>Üyelik bilgileri hatalı</message>
  </status>
</response>
```

--------------------------------

### Example XML Request for Blacklist API

Source: https://www.toplusmsapi.com/numara-engelle/liste/xml

An example of a valid XML request body for the blacklist API. This specific example sets the page to 1 and rowCount to 30, without applying date filters.

```xml
<request>
  <authentication>
    <key></key>
    <hash></hash>
  </authentication>
  <blacklist>
    <page>1</page>
    <rowCount>30</rowCount>
  </blacklist>
</request>
```

--------------------------------

### Example Successful API Response (XML)

Source: https://www.toplusmsapi.com/hesap/bakiye/xml

An example of a successful response from the get-balance API. It confirms the transaction was successful with a '200' status code and provides the current TL balance in 'amount' and SMS balance in 'sms'.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>
    <message>İşlem başarılı</message>
  </status>
  <balance>
    <amount>134.0000</amount>
    <sms>7538</sms>
  </balance>
</response>
```

--------------------------------

### Request and Response Examples

Source: https://www.toplusmsapi.com/sms/rapor/liste/xml

Provides examples of successful and unsuccessful API requests and responses, demonstrating the expected XML structure for various operations.

```APIDOC
## Example Request

```xml
<?xml version="1.0" encoding="UTF-8" ?>
<request>
  <authentication>
    <key>demo</key>
    <hash>demo</hash>
  </authentication>
  <order>
    <id>428</id>
    <page>1</page>
    <rowCount>5</rowCount>
  </order>
</request>
```

## Example Successful Response

```xml
<?xml version="1.0" encoding="UTF-8" ?>
<response>
  <status>
    <code>200</code>
    <message>Transaction successful</message>
  </status>
  <order>
    <id>428</id>
    <status>113</status>
    <message>
      <number>5301234567</number>
      <status>110</status>
    </message>
    <message>
      <number>5301234568</number>
      <status>111</status>
    </message>
    <message>
      <number>5301234569</number>
      <status>110</status>
    </message>
    <message>
      <number>5301234560</number>
      <status>111</status>
    </message>
    <message>
      <number>5301234561</number>
      <status>111</status>
    </message>
  </order>
</response>
```

## Example Error Response

```xml
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>455</code>
    <message>Order not found</message>
  </status>
</response>
```
```

--------------------------------

### Example Request

Source: https://www.toplusmsapi.com/sms/rapor/liste/json

An example of a request body sent to the API, including authentication details and order information.

```APIDOC
## Example Request

```json
{
  "request": {
    "authentication": {
      "key": "507caf2e1fcdb5eea9786332ca2d8785",
      "hash": "0db4e316db72c519ba08121985f6ddf479809053d555c"
    },
    "order": {
      "id": 428,
      "page": 1,
      "rowCount": 5
    }
  }
}
```
```

--------------------------------

### Example Request to Add Number to Blacklist (XML)

Source: https://www.toplusmsapi.com/numara-engelle/ekle/xml

An example of a complete XML request to add a phone number to the blacklist. This demonstrates how to populate the authentication and blacklist fields.

```xml
<?xml version="1.0" encoding="UTF-8" ?>
<request>
  <authentication>
    <key></key>
    <hash></hash>
  </authentication>
  <blacklist>
    <number>+90505xxxxxxx</number>
  </blacklist>
</request>
```

--------------------------------

### SMS Text URL Encoding Example

Source: https://www.toplusmsapi.com/sms/gonder/get

Demonstrates the necessity of URL encoding SMS message text before sending through the API. Special characters and spaces must be properly encoded to prevent URL corruption. Shows both unencoded and encoded versions of the same message.

```text
&text=Encode edilmemiş mesaj metni örneği

&text=Encode%20edilmemi%C5%9F%20mesaj%20metni%20%C3%B6rne%C4%9Fi
```

--------------------------------

### Get Blacklist JSON Example Request

Source: https://www.toplusmsapi.com/numara-engelle/liste/json

Engellenen numaraların listesini almak için örnek bir POST isteği. Kimlik doğrulama bilgileri ve sayfalama parametreleri belirtilmiştir.

```json
{
  "request": {
    "authentication": {
      "key": "",
      "hash": ""
    },
    "blacklist": {
      "page": 1,
      "rowCount": 5
    }
  }
}
```

--------------------------------

### Example Successful XML Response

Source: https://www.toplusmsapi.com/numara-engelle/liste/xml

This is an example of a successful response from the blacklist API. It indicates a 200 status code, a success message, and a list of blocked numbers with their total count.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>
    <message>İşlem başarılı</message>
  </status>
  <blacklist>
    <count>334</count>
    <number>+905558650220</number>
    <number>+905558650220</number>
    <number>+905558650220</number>
    <number>+905558650220</number>
  </blacklist>
</response>
```

--------------------------------

### Example Error Server Response (XML)

Source: https://www.toplusmsapi.com/numara-engelle/ekle/xml

This XML structure shows an example of an error response from the server, such as when an invalid number is provided. It includes an error code and a descriptive message.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>466</code>
    <message>Hatalı numara.</message>
  </status>
</response>
```

--------------------------------

### Example Successful Response

Source: https://www.toplusmsapi.com/sms/rapor/liste/json

An example of a successful response from the API, indicating that the operation was completed successfully and providing order details.

```APIDOC
## Example Successful Response

```json
{
  "response": {
    "status": {
      "code": 200,
      "message": "İşlem başarılı"
    },
    "order": {
      "id": 428,
      "status": 113,
      "message": [
        {
          "number": 5301234567,
          "status": 110
        },
        {
          "number": 5301234568,
          "status": 111
        },
        {
          "number": 5301234569,
          "status": 112
        },
        {
          "number": 5301234560,
          "status": 111
        },
        {
          "number": 5301234561,
          "status": 111
        }
      ]
    }
  }
}
```
```

--------------------------------

### Example Error Response

Source: https://www.toplusmsapi.com/sms/rapor/liste/json

An example of an error response from the API, illustrating the structure when an order is not found.

```APIDOC
## Example Error Response

```json
{
  "response": {
    "status": {
      "code": 455,
      "message": "Sipariş bulunamadı"
    }
  }
}
```
```

--------------------------------

### Get Blacklist JSON Example Error Response

Source: https://www.toplusmsapi.com/numara-engelle/liste/json

Kimlik bilgileri hatalı olduğunda engellenen numaraların listesini almak için yapılan bir POST isteğine örnek sunucu hatası yanıtı. Hata kodu ve mesajını içerir.

```json
{
  "response": {
    "status": {
      "code": 401,
      "message": "Üyelik bilgileri hatalı"
    }
  }
}
```

--------------------------------

### Example Webhook Request Payload (JSON)

Source: https://www.toplusmsapi.com/sms/rapor/liste/webhook

Provides a concrete example of a webhook request payload. This illustrates the actual data format that will be sent to your configured URL when an SMS package status changes. It includes sample values for each field within the 'report' object, demonstrating how to interpret the received information.

```json
{
  "report": {
    "id": 1599558518,
    "packet_id": 104525848,
    "status": "accepted",
    "to": "+90505702xxxx",
    "body": "Webhook test mesaji"
  }
}
```

--------------------------------

### XML Post API Successful Response Example

Source: https://www.toplusmsapi.com/sms/baslik/liste/xml

Example of a successful API response with HTTP 200 status code. Contains status information indicating successful operation (code 200 and Turkish success message) and a senders list with one approved sender 'eMarka'.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>
    <message>İşlem başarılı</message>
  </status>
  <senders>
    <sender>eMarka</sender>
  </senders>
</response>
```

--------------------------------

### Example Cancel SMS Order API Request (JSON)

Source: https://www.toplusmsapi.com/sms/iptal/json

An example of a complete JSON request body for cancelling an SMS order using the Toplusms API. This includes sample authentication key, hash, and order ID.

```json
{
  "request": {
    "authentication": {
      "key": "507caf2e1fcdb5eea9786332ca2d8785",
      "hash": "0db4e316db72c519ba08121985f6ddf479809053d555c"
    },
    "order": {
      "id": "428"
    }
  }
}
```

--------------------------------

### Example Successful Server Response (XML)

Source: https://www.toplusmsapi.com/numara-engelle/ekle/xml

This XML structure represents a successful response from the server after a number has been added to the blacklist. It includes a status code and a success message.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>
    <message>İşlem başarılı</message>
  </status>
</response>
```

--------------------------------

### POST /v1/get-groups

Source: https://www.toplusmsapi.com/rehber/grup/liste/xml

Bu endpoint, rehberinizde tanımlı olan grupların listesini XML formatında almanızı sağlar. Kimlik doğrulama için `key` ve `hash` gereklidir.

```APIDOC
## POST /v1/get-groups

### Description
Bu endpoint, rehberinizde tanımlı olan grupların listesini XML formatında almanızı sağlar. Kimlik doğrulama için `key` ve `hash` gereklidir.

### Method
POST

### Endpoint
`https://api.iletimerkezi.com/v1/get-groups`

### Parameters
#### Request Body
- **request** (xml) - Required - XML formatında istek.
  - **authentication** (xml) - Required - Kimlik doğrulama bilgileri.
    - **key** (string) - Required - iletimerkezi.com panelinizden alınan API Anahtarı.
    - **hash** (string) - Required - API Anahtarı ve Gizli Anahtar ile oluşturulan hash.

### Request Example
```xml
<request>
  <authentication>
    <key>YOUR_API_KEY</key>
    <hash>YOUR_HASH</hash>
  </authentication>
</request>
```

### Response
#### Success Response (200)
- **response** (xml) - İşlem sonucu.
  - **status** (xml) - İşlem durumu.
    - **code** (integer) - İşlem durumunu belirten kod.
    - **message** (string) - İşlem durumu hakkında mesaj.
  - **groups** (xml) - İşlem başarılıysa grubun bilgileri.
    - **group** (xml) - Grubun bilgileri.
      - **id** (string) - Grubu temsil eden benzersiz değer.
      - **name** (string) - Grubun ismi.
      - **count** (integer) - Grup içindeki kişi sayısı.
      - **children** (xml) - Grubun alt grupları.
        - **child** (xml) - Grubun alt grubunun bilgileri.
          - **id** (string) - Alt grubu temsil eden benzersiz değer.
          - **name** (string) - Alt grubun ismi.
          - **count** (integer) - Alt grup içindeki kişi sayısı.

#### Response Example
```xml
<response>
  <status>
    <code>200</code>
    <message>Success</message>
  </status>
  <groups>
    <group>
      <id>123</id>
      <name>Ana Grup 1</name>
      <count>50</count>
      <children>
        <child>
          <id>123-1</id>
          <name>Alt Grup 1.1</name>
          <count>20</count>
        </child>
      </children>
    </group>
  </groups>
</response>
```

### Error Codes
- **400**: İstek çözümlenemedi (XML yapısı hatası).
- **401**: Üyelik bilgileri hatalı (API Anahtarı veya Hash hatalı, veya IP eşleşmiyor).
- **404**: API istek yapılan adres bulunamadı.
```

--------------------------------

### POST /v1/get-balance

Source: https://www.toplusmsapi.com/hesap/bakiye/xml

This endpoint allows you to retrieve your account balance, including TL and SMS credits, by sending an XML request.

```APIDOC
## POST /v1/get-balance

### Description
Retrieve your account balance information, including TL and SMS credits, using an HTTP POST request with an XML payload.

### Method
POST

### Endpoint
`https://api.iletimerkezi.com/v1/get-balance`

### Parameters
#### Request Body
- **request** (xml) - Required - The root element for the request.
  - **authentication** (xml) - Required - Contains authentication credentials.
    - **key** (string) - Required - Your API key obtained from the iletimerkezi.com panel.
    - **hash** (string) - Required - A hash generated using your API key and secret key from the iletimerkezi.com panel.

### Request Example
```xml
<request>
  <authentication>
    <key>YOUR_API_KEY</key>
    <hash>YOUR_GENERATED_HASH</hash>
  </authentication>
</request>
```

### Response
#### Success Response (200)
- **response** (xml) - Contains the status and balance information.
  - **status** (xml) - Information about the transaction status.
    - **code** (integer) - The status code of the operation.
    - **message** (string) - A message describing the status of the operation.
  - **balance** (xml) - Your account balance details.
    - **amount** (float) - Your available TL balance.
    - **sms** (integer) - Your available SMS credit.

#### Response Example
```xml
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>200</code>
    <message>İşlem başarılı</message>
  </status>
  <balance>
    <amount>134.0000</amount>
    <sms>7538</sms>
  </balance>
</response>
```

#### Error Responses
- **400 Bad Request**: The XML request structure is invalid (e.g., incorrect tags, unclosed tags, invalid characters).
- **401 Unauthorized**: Invalid or unverified authentication credentials. This can also occur if you are using a static IP address that is not registered with your account.
- **404 Not Found**: The API endpoint address is incorrect. Please double-check the URL.
```

--------------------------------

### Get Blacklist JSON Example Successful Response

Source: https://www.toplusmsapi.com/numara-engelle/liste/json

Engellenen numaraların listesini başarıyla alan bir POST isteğine örnek sunucu yanıtı. İşlem kodu, mesajı ve engellenen numaraların listesini içerir.

```json
{
  "response": {
    "status": {
      "code": 200,
      "message": "İşlem başarılı"
    },
    "blacklist": {
      "count": "7906",
      "number": [
        "+905050047824",
        "+905050047824",
        "+905050047824",
        "+905050047824",
        "+905050047824"
      ]
    }
  }
}
```

--------------------------------

### Ruby Gem Kurulumu - iletimerkezi

Source: https://www.toplusmsapi.com/ornekler/ruby-sms-g%C3%B6nderme

iletimerkezi.com API'leri ile entegrasyon için Ruby gem'ini kurar. Gemfile'a eklenerek veya doğrudan gem install komutu ile kurulabilir. `bundle` komutu ile bağımlılıklar yönetilir.

```ruby
gem 'ileti_merkezi'
```

```bash
$ bundle
$ gem install ileti_merkezi
```

--------------------------------

### GET /v1/send-sms/get

Source: https://www.toplusmsapi.com/sms/gonder/get

This endpoint allows you to send SMS messages using an HTTP GET request. It's useful for integrating SMS functionality into various platforms and devices.

```APIDOC
## GET /v1/send-sms/get

### Description
This endpoint allows you to send SMS messages using an HTTP GET request. It's useful for integrating SMS functionality into various platforms and devices.

### Method
GET

### Endpoint
`https://api.iletimerkezi.com/v1/send-sms/get/`

### Parameters
#### Query Parameters
- **key** (string) - Required - API key obtained from your iletimerkezi.com panel.
- **hash** (string) - Required - Hash generated using your API key and secret key from your iletimerkezi.com panel.
- **text** (string) - Required - The content of the SMS message. Must be URL encoded.
- **receipents** (string) - Required - The recipient's mobile number(s). Format should be 5xxxxxxxxx. Multiple numbers should be separated by commas.
- **sender** (string) - Required - Sender ID, defined and approved by iletimerkezi.com, maximum 11 characters. Must be URL encoded.
- **iys** (integer) - Required - Indicates whether to query the message via the Message Management System (IYS). Use 1 for true (query) and 0 for false (do not query). This is mandatory for commercial messages.
- **iysList** (string) - Optional - Specifies the list to query via IYS. Must be either 'BIREYSEL' (Individual) or 'TACIR' (Commercial) if 'iys' is set to 1.

### Request Example
```json
{
  "example": "https://api.iletimerkezi.com/v1/send-sms/get/?key=3ea65b1e8baxxxx&hash=XXXX&text=Lorem%20ipsum%20dolor%20sit%20amet&receipents=5301234569,5301234570&sender=APITEST&iys=1&iysList=BIREYSEL"
}
```

### Response
#### Success Response (200)
- **status.code** (integer) - Numeric value indicating the transaction status.
- **status.message** (string) - Informational message about the transaction status.
- **order.id** (string) - Unique numeric value representing the order, returned only if the transaction is successful.

#### Response Example
```json
{
  "example": "<response>\n  <status>\n    <code></code>\n    <message></message>\n  </status>\n  <order>\n    <id></id>\n  </order>\n</response>"
}
```
```

--------------------------------

### Get Sender List JSON Request

Source: https://www.toplusmsapi.com/sms/baslik/liste/json

This JSON object represents the request body for the Get Sender API endpoint. It includes authentication details required to access the API. The 'key' and 'hash' fields must be populated with valid credentials.

```json
{
  "request": {
    "authentication": {
      "key": "YOUR_API_KEY",
      "hash": "YOUR_API_HASH"
    }
  }
}
```

--------------------------------

### Get Sender List JSON Response (Success)

Source: https://www.toplusmsapi.com/sms/baslik/liste/json

This JSON object illustrates a successful response from the Get Sender API. It contains a status object with a success code and message, followed by the 'senders' object which lists the approved sender IDs in an array.

```json
{
  "response": {
    "status": {
      "code": 200,
      "message": "İşlem başarılı"
    },
    "senders": {
      "sender": [
        "APITEST",
        "eMarka"
      ]
    }
  }
}
```

--------------------------------

### SMS GET API Request URL with Parameters

Source: https://www.toplusmsapi.com/sms/gonder/get

Complete HTTP GET request URL for sending SMS messages through İleti Merkezi API. Requires API key, hash, message text (URL encoded), recipient phone numbers in 5xxxxxxxxx format, sender name (max 11 characters), and İYS (Message Management System) parameters. Multiple recipients are separated by commas.

```http
https://api.iletimerkezi.com/v1/send-sms/get/?key=API_KEY&hash=API_HASH&text=Lorem%20ipsum%20dolor%20sit%20amet&receipents=5301234569,5301234570&sender=APITEST&iys=1&iysList=BIREYSEL
```

--------------------------------

### XML Response Structure for Get Groups API

Source: https://www.toplusmsapi.com/rehber/grup/liste/xml

This XML structure represents the server's response to the Get Groups API request. It includes a status object with code and message, and a groups object containing details of your address book groups if the request was successful.

```xml
<response>
  <status>
    <code></code>
    <message></message>
  </status>
  <groups>
    <group>
      <id></id>
      <name></name>
      <count></count>
      <children>
        <child>
          <id></id>
          <name></name>
          <count></count>
        </child>
      </children>
    </group>
  <groups>
</response>
```

--------------------------------

### XML Order Request Example for Toplu SMS API

Source: https://www.toplusmsapi.com/sms/gonder/xml

This XML snippet demonstrates a sample request for placing an order with the Toplu SMS API. It includes authentication details, sender information, message content, and recipient numbers for multiple messages. Note the use of CDATA for message text to handle special characters.

```xml
<?xml version="1.0" encoding="UTF-8" ?>
<request>
  <authentication>
    <key>demo</key>
    <hash>demo</hash>
  </authentication>
  <order>
    <sender>APITEST</sender>
    <sendDateTime>23/04/2022 09:00</sendDateTime>
    <message>
      <text><![CDATA[Test mesaji.]]></text>
      <receipents>
        <number>5301234567</number>
        <number>5301234568</number>
      </receipents>
    </message>
    <message>
      <text><![CDATA[Demo mesaji.]]></text>
      <receipents>
        <number>5301234569</number>
        <number>5301234560</number>
      </receipents>
    </message>
  </order>
</request>
```

--------------------------------

### Order Placement API

Source: https://www.toplusmsapi.com/sms/gonder/xml

This endpoint allows you to place SMS orders. It supports multiple messages within a single order and provides order details upon successful completion. If the operation fails, specific error codes will be returned.

```APIDOC
## POST /websites/toplusmsapi

### Description
This endpoint is used to place SMS orders. It processes requests containing authentication details, sender information, message content, and recipient numbers. A successful request returns an order ID, while failures are indicated by specific error codes.

### Method
POST

### Endpoint
/websites/toplusmsapi

### Parameters
#### Request Body
- **request** (XML) - Required - The root element for the API request.
  - **authentication** (XML) - Required - Authentication credentials.
    - **key** (string) - Required - Your API key.
    - **hash** (string) - Required - Your API hash.
  - **order** (XML) - Required - Contains order details.
    - **sender** (string) - Required - The sender ID for the SMS messages. Must be approved in your account.
    - **sendDateTime** (string) - Optional - The date and time to send the SMS. Format: GG/AA/YYYY SS:DD.
    - **message** (XML) - Required - Contains message details. This tag can be repeated for multiple messages.
      - **text** (string) - Required - The content of the SMS message. Use CDATA for special characters. Maximum length depends on character encoding (e.g., 7 SMS for standard encoding).
      - **receipents** (XML) - Required - Contains recipient phone numbers.
        - **number** (string) - Required - A phone number to send the SMS to. Can be repeated for multiple recipients.

### Request Example
```xml
<?xml version="1.0" encoding="UTF-8" ?>
<request>
  <authentication>
    <key>demo</key>
    <hash>demo</hash>
  </authentication>
  <order>
    <sender>APITEST</sender>
    <sendDateTime>23/04/2022 09:00</sendDateTime>
    <message>
      <text><![CDATA[Test mesaji.]]></text>
      <receipents>
        <number>5301234567</number>
        <number>5301234568</number>
      </receipents>
    </message>
    <message>
      <text><![CDATA[Demo mesaji.]]></text>
      <receipents>
        <number>5301234569</number>
        <number>5301234560</number>
      </receipents>
    </message>
  </order>
</request>
```

### Response
#### Success Response (200)
- **response** (XML) - Contains the status and order information.
  - **status** (XML) - Status of the operation.
    - **code** (string) - Empty if successful.
    - **message** (string) - Empty if successful.
  - **order** (XML) - Order details.
    - **id** (string) - The unique ID of the created order. Used for status checks and cancellations.

#### Response Example
```xml
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code></code>
    <message></message>
  </status>
  <order>
    <id></id>
  </order>
</response>
```

#### Error Handling
If the request fails, the response will contain an error code and message within the `<status>` tag. Common error codes include:
- **400**: Bad Request (JSON structure error).
- **401**: Invalid Authentication Credentials.
- **402**: Insufficient Balance.
- **450**: Invalid Sender ID.
- **451**: Duplicate Order (within 10 minutes).
- **452**: Invalid Recipients.
- **453**: Message Size Exceeded.
- **454**: Empty Message Text.
- **457**: Invalid Send Date/Time Format.
- **468**: IYS Checkbox Setting Required.
- **469**: IYS List (BIREYSEL or TACIR) Selection Required.
- **470**: IYS Code Setting Required.

#### Error Response Example
```xml
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>400</code>
    <message>İstek çözümlenemedi</message>
  </status>
</response>
```
```

--------------------------------

### Send SMS using Java HTTP POST Request

Source: https://www.toplusmsapi.com/ornekler/java-sms-g%C3%B6nderme

This Java code snippet demonstrates how to send SMS messages via the Iletimerkezi API. It constructs an XML request containing authentication details, sender information, message text, and recipient numbers. The code then makes an HTTP POST request to the API endpoint and returns the response.

```java
package api;
import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;

public class Api {

	public static void main(String[] args) {

		String xml = "<request>";
        xml += "<authentication>";
        xml += "<username></username>";
        xml += "<password></password>";
        xml += "</authentication>";
        xml += "<order>";
        xml += "<sender>ILETI MRKZI</sender>";
        xml += "<sendDateTime></sendDateTime>";
        xml += "<message>";
        xml += "<text><![CDATA[Java sms test mesaji]]></text>";
        xml += "<receipents>";
        xml += "<number></number>";
        xml += "</receipents>";
        xml += "</message>";
        xml += "</order>";
        xml += "</request>";

		excutePost("https://api.iletimerkezi.com/v1/send-sms",xml);
	}

	public static String excutePost(String targetURL, String xml) {

		String urlParameters = null;
		try {
			urlParameters = "data=" + URLEncoder.encode(xml,"UTF-8");
		} catch (UnsupportedEncodingException e1) {
			e1.printStackTrace();
		}

	    URL url;

	    HttpURLConnection connection = null;

	    try {

	      //Create connection
	      url = new URL(targetURL);

	      connection = (HttpURLConnection)url.openConnection();
	      connection.setRequestMethod("POST");
	      connection.setRequestProperty("Content-Type","application/x-www-form-urlencoded");
	      connection.setRequestProperty("Content-Length", "" + Integer.toString(urlParameters.getBytes().length));
	      connection.setRequestProperty("Content-Language", "UTF-8");
	      connection.setUseCaches (false);
	      connection.setDoInput(true);
	      connection.setDoOutput(true);

	      //Send request
	      DataOutputStream wr = new DataOutputStream (connection.getOutputStream ());
	      wr.writeBytes (urlParameters);
	      wr.flush ();
	      wr.close ();

	      //System.out.println(connection.getResponseMessage());
	      //Get Response
	      InputStream is = connection.getInputStream();
	      BufferedReader rd = new BufferedReader(new InputStreamReader(is,"UTF-8"));
	      String line;
	      StringBuffer response = new StringBuffer();

	      while((line = rd.readLine()) != null) {
	        response.append(line);
	        response.append('\r');
	      }

	      rd.close();
	      return response.toString();

	    } catch (Exception e) {
	    	e.printStackTrace();
	    	return null;
	    } finally {
	    	if(connection != null) {
	    		connection.disconnect();
	    	}
	    }

	  }
}
```

--------------------------------

### Ruby ile Tek SMS Gönderme - Çoklu Alıcı

Source: https://www.toplusmsapi.com/ornekler/ruby-sms-g%C3%B6nderme

iletimerkezi kütüphanesini kullanarak tek bir SMS'i birden fazla alıcıya gönderme örneği. Gönderim zamanı, gönderici adı, alıcı telefon numaraları ve mesaj metni argüman olarak verilir. Yanıt nesnesi işlem durumu, gövdesi ve hata bilgileri içerir.

```ruby
args = {
  send_datetime: '15/01/2017 12:00', # Opsiyonel
  sender: 'TEST', # Opsiyonel
  phones: ['0555 555 00 01', '0555 555 00 02'],
  text: 'Test Mesajı'
}

# return IletiMerkezi::Response
response = IletiMerkezi.send(args)
# veya
sms      = IletiMerkezi::Sms.new(args)
response = sms.send

response.code # return 200
response.body # http raw body
response.message # return status message
response.error? # return true or false
response.to_h
# return hash
{
  :status => {
    :code => "200",
    :message => "İşlem başarılı"
  },
  :order => {
    :id => "order_id"
  }
}
```

--------------------------------

### Get Blacklist JSON Request Structure

Source: https://www.toplusmsapi.com/numara-engelle/liste/json

Engellenen numaraların listesini JSON formatında almak için POST isteğinin ana yapısı. Kimlik doğrulama bilgileri ve filtreleme/sayfalama parametrelerini içerir.

```json
{
  "request": {
    "authentication": {
      "key": "",
      "hash": ""
    },
    "blacklist": {
      "filter": {
        "start": "",
        "end": ""
      },
      "page": "",
      "rowCount": ""
    }
  }
}
```

--------------------------------

### Örnek Başarılı Yanıt Yapısı (XML)

Source: https://www.toplusmsapi.com/sms/rapor/liste/xml

API'den alınabilecek başarılı bir yanıtın XML yapısını gösterir. İşlem başarılı olduğunda dönen durumu ve sipariş bilgilerini içerir.

```xml
<?xml version="1.0" encoding="UTF-8" ?>
<response>
  <status>
    <code>200</code>
    <message>İşlem başarılı</message>
  </status>
  <order>
    <id>428</id>
    <status>113</status>
    <message>
      <number>5301234567</number>
      <status>110</status>
    </message>
    <message>
      <number>5301234568</number>
      <status>111</status>
    </message>
    <message>
      <number>5301234569</number>
      <status>110</status>
    </message>
    <message>
      <number>5301234560</number>
      <status>111</status>
    </message>
    <message>
      <number>5301234561</number>
      <status>111</status>
    </message>
  </order>
</response>
```

--------------------------------

### Get Blacklist JSON Response Structure

Source: https://www.toplusmsapi.com/numara-engelle/liste/json

Engellenen numaraların listesini almak için yapılan JSON POST isteğine sunucu tarafından verilen başarılı yanıtın yapısı. Durum bilgisi ve engellenen numaraları içerir.

```json
{
  "response": {
    "status": {
      "code": "",
      "message": ""
    },
    "blacklist": {
      "count": "",
      "number": [
        "505xxxxxxx",
        "532xxxxxxx"
      ]
    }
  }
}
```

--------------------------------

### XML Request Body for Blacklist API

Source: https://www.toplusmsapi.com/numara-engelle/liste/xml

This XML structure is sent as the request body to the blacklist API endpoint. It includes authentication credentials (key and hash) and parameters for filtering and pagination of the blacklist.

```xml
<request>
  <authentication>
    <key></key>
    <hash></hash>
  </authentication>
  <blacklist>
    <filter>
      <start></start>
      <end></end>
    </filter>
    <page></page>
    <rowCount></rowCount>
  </blacklist>
</request>
```

--------------------------------

### POST /v1/add-group

Source: https://www.toplusmsapi.com/rehber/grup/ekle/xml

Use this endpoint to create a new group in your address book by sending an XML request. Ensure you include valid authentication credentials and group information.

```APIDOC
## POST /v1/add-group

### Description
Creates a new group in the address book using an XML POST request.

### Method
POST

### Endpoint
`https://api.iletimerkezi.com/v1/add-group`

### Parameters
#### Request Body
- **request** (xml) - Required - The root element for the request.
  - **authentication** (xml) - Required - Contains authentication credentials.
    - **key** (string) - Required - Your API key from iletimerkezi.com.
    - **hash** (string) - Required - The hash generated using your API key and secret key.
  - **group** (xml) - Required - Contains information about the group to be created.
    - **name** (string) - Required - The name of the group to be created. CDATA is recommended for special characters.
    - **parent** (string) - Optional - The ID of the parent group if this is a sub-group. Leave empty if it's a main group.

### Request Example
```xml
<request>
  <authentication>
    <key>YOUR_API_KEY</key>
    <hash>YOUR_HASH</hash>
  </authentication>
  <group>
    <name><![CDATA[My New Group]]></name>
    <parent></parent>
  </group>
</request>
```

### Response
#### Success Response (200)
- **response** (xml) - Contains the status and group information.
  - **status** (xml) - Information about the transaction status.
    - **code** (integer) - Status code of the operation.
    - **message** (string) - Message describing the status of the operation.
  - **group** (xml) - Information about the created group.
    - **id** (string) - The unique ID of the created group.
    - **name** (string) - The name of the created group.

#### Response Example
```xml
<response>
  <status>
    <code>200</code>
    <message>Success</message>
  </status>
  <group>
    <id>12345</id>
    <name>My New Group</name>
  </group>
</response>
```

### Error Codes
- **400**: Bad Request - Invalid XML structure.
- **401**: Unauthorized - Invalid membership information or IP address mismatch.
- **404**: Not Found - The requested API endpoint does not exist.
- **461**: Bad Request - Group name cannot be empty.
- **463**: Bad Request - Parent group ID not found.
```

--------------------------------

### Örnek Hatalı Yanıt Yapısı (XML)

Source: https://www.toplusmsapi.com/sms/rapor/liste/xml

API'den alınabilecek hatalı bir yanıtın XML yapısını gösterir. Hata kodu ve mesajını içerir.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>
    <code>455</code>
    <message>Sipariş bulunamadı</message>
  </status>
</response>
```
Tokens:
Raw