Skip to main content

JSON Post API

Warning

This API method is under development, there may be changes to it. Please contact your customer representative to access the API method.

You can follow the instructions below to create a new group in your directory in JSON format using the POST method of the HTTP protocol.

Address to request

POSThttps://api.iletimerkezi.com/v1/add-group/json

Request Content (Body)

Content of the request if you are processing using API Key
{
"request": {
"authentication": {
"key": "",
"hash": ""
},
"group": {
"name": "",
"parent": []
}
}
}

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:

  • key: API Key that you can create from the settings section should be written in this field after logging in to your iletimerkezi.com panel. It is required to be sent when making a request.

  • hash: After logging into your iletimerkezi.com panel, the hash generated using the API Key and Secret Key that you can create from the settings section should be written in this field. It is required to be sent when making a request.

group

Contains information about the group to be created. The alt tags are as follows.

  • name: Contains the name of the group to be created.
  • parent: If the group to be created is a subgroup of a group, you must send the id value of that group, if the group you created is the main group, you must send it blank.

Server response

{
"response": {
"status": {
"code": "",
"message": ""
},
"group": {
"id": "",
"name": ""
}
}
}

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.

group

Represents your group information. The definition of subtags of this tag is as follows:

  • id: Contains the unique value of the created group.
  • name: Contains the name of the created group.