Skip to main content

XML Post API

If you want to receive the approved header list defined in your account in XML format using the POST method of the HTTP protocol, you can follow the instructions below.

Address to request

POSThttps://api.iletimerkezi.com/v1/get-sender

Request Content (Body)

Content of the request if you are using username and password
<request>
<authentication>
<username></username>
<password></password>
</authentication>
</request>
Content of the request if you are processing using API Key
<request>
<authentication>
<key></key>
<hash></hash>
</authentication>
</request>

Definitions

The request to the server must be wrapped with the request tag. The definitions of the subtags of this tag are as follows:

authentication

It is the user information that must be sent in order to receive authorization for the requested operation. The alt tags are as follows:

  • username: is the user name used when logging into iletimerkezi.com. The mobile phone number you used while registering. It is required to be sent when making a request.
  • password is the password used when logging into iletimerkezi.com. It is required to be sent when making a request.

Server response

<response>
<status>
<code></code>
<message></message>
</status>
<senders>
<sender></sender>
<sender></sender>
<sender></sender>
<senders>
</response>

Definitions

The response from the server is always wrapped in the response tag. The definition of subtags of this tag is as follows:

status

Contains information about the transaction status. The values ​​returned by this tag can also be obtained by looking at the header information of the HTTP response. This tag is returned by default on every request made. The alt tags are as follows

  • code: It is the numerical value that indicates the operation status.
  • message: Contains an informational message about the transaction status.

senders

Contains the order information created if the transaction was completed successfully. If the operation fails, this tag is not returned. The alt tags are as follows:

  • sender: Contains approved header information.

Error Codes

If the result of the request is negative, the error codes and messages that will be returned to you by the server are as follows.

codemessageDescription
400The request could not be resolved is caused by an error in the structure of the XML you POST. These errors are usually caused by a misspelled XML tag, an improperly closed XML tag, or the use of a character that can break the structure of XML without using CDATA.
401Incorrect membership informationWe give this error when we can't verify the information you have submitted in the authentication tag of the XML you POST. If you have defined a fixed IP in your account and you are requesting from a different IP, you will get this error again.
404API does not have requested methodIf you're getting this error, double-check the address you requested, you may be making a request to a wrong address.

Sample Request

<?xml version="1.0" encoding="UTF-8" ?>
<request>
<authentication>
<username>demo</username>
<password>demo</password>
</authentication>
</request>

Example Successful Response

<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<message>Operation successful</message>
</status>
<sender>
<sender>eBrand</sender>
</senders>
</response>

Example Incorrect Answer

<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>401</code>
<message>Membership information is incorrect</message>
</status>
</response>