api-client-dotnet/README.md

134 lines
3.7 KiB
Markdown
Raw Normal View History

2015-02-02 14:46:14 +03:00
.NET-клиент для retailCRM API
=============================
2014-11-03 13:50:28 +03:00
2015-02-02 14:46:14 +03:00
.NET-клиент для работы с [RetailCRM API](http://www.retailcrm.ru/docs/rest-api/index.html).
2014-11-03 13:50:28 +03:00
version: 3.0.0
2015-02-02 14:46:14 +03:00
Обязательные требования
-----------------------
2014-11-03 13:50:28 +03:00
* [Newtonsoft.Json](http://james.newtonking.com/json)
2015-02-02 14:46:14 +03:00
Примеры использования
---------------------
2014-11-03 13:50:28 +03:00
2015-02-02 14:46:14 +03:00
### Получение информации о заказе
2014-11-03 13:50:28 +03:00
2014-11-03 13:52:08 +03:00
``` csharp
2014-11-03 13:50:28 +03:00
using RetailCrm;
2015-02-02 14:39:46 +03:00
using RetailCrm.Response;
2014-11-03 13:50:28 +03:00
...
2015-02-02 14:39:46 +03:00
ApiClient api;
try
{
2015-02-02 14:46:14 +03:00
api = new ApiClient(
"https://demo.retailcrm.ru",
"T9DMPvuNt7FQJMszHUdG8Fkt6xHsqngH"
);
2015-02-02 14:39:46 +03:00
}
catch (WebException e)
{
System.Console.WriteLine(e.ToString());
}
2014-11-03 13:50:28 +03:00
2015-02-02 14:46:14 +03:00
ApiResponse response = null;
try
{
response = api.ordersGet("M-2342");
}
catch (WebException e)
{
System.Console.WriteLine(e.ToString());
}
2014-11-03 13:50:28 +03:00
2015-02-02 14:46:14 +03:00
if (response.isSuccessful()) {
System.Console.WriteLine(response["totalSumm"]);
} else {
System.Console.WriteLine(
"Ошибка получения информации о заказа: [Статус HTTP-ответа " +
response["statusCosde"] + "] " +
response["errorMsg"]
);
}
```
### Создание заказа
2014-11-03 13:50:28 +03:00
2014-11-03 13:52:08 +03:00
``` csharp
2015-02-02 14:39:46 +03:00
using RetailCrm;
using RetailCrm.Response;
...
2015-02-02 14:36:40 +03:00
ApiClient api;
2014-11-03 13:50:28 +03:00
string url, key;
2015-02-02 14:36:40 +03:00
try
{
api = new ApiClient(url, key);
}
catch (WebException e)
{
System.Console.WriteLine(e.ToString());
}
Dictionary<string, object> tmpOrder = new Dictionary<string, object>(){
{"number", "example"},
{"externalId", "example"},
{"createdAt", DateTime.Now.ToString("Y-m-d H:i:s")},
{"discount", 50},
{"phone", "89263832233"},
2015-02-02 14:39:46 +03:00
{"email", "example@gmail.com"},
2015-02-02 14:36:40 +03:00
{"customerComment", "example"},
{"customFields", new Dictionary<string, object>(){
{"reciever_phone", "example"},
{"reciever_name", "example"},
{"ext_number", "example"}
}
},
{"contragentType", "individual"},
{"orderType", "eshop-individual"},
{"orderMethod", "app"},
{"customerId", "555"},
{"managerId", 8},
{"items", new Dictionary<string, object>(){
{"0", new Dictionary<string, object>(){
{"initialPrice", 100},
{"quantity", 1},
{"productId", 55},
{"productName", "example"}
}
}
}
},
{"delivery", new Dictionary<string, object>(){
{"code", "courier"},
{"date", DateTime.Now.ToString("Y-m-d")},
{"address", new Dictionary<string, object>(){
{"text", "exampleing"}
}
}
}
}
};
ApiResponse response = null;
try
{
response = api.ordersEdit(order);
}
catch (WebException e)
{
System.Console.WriteLine(e.ToString());
}
if (response.isSuccessful() && 201 == response["statusCosde"]) {
2015-02-02 14:46:14 +03:00
System.Console.WriteLine(
"Заказ успешно создан. ID заказа в retailCRM = " + response["id"]
);
2015-02-02 14:36:40 +03:00
} else {
2015-02-02 14:39:46 +03:00
System.Console.WriteLine(
2015-02-02 14:46:14 +03:00
"Ошибка создания заказа: [Статус HTTP-ответа " +
response["statusCosde"] + "] " +
response["errorMsg"]
2015-02-02 14:39:46 +03:00
);
2014-11-03 13:50:28 +03:00
}
2015-02-02 14:39:46 +03:00
```