POST api/ESSystem/v1/GeneratorCycles/reads/add

يضيف قراءة ساعية للدورة (يتحقق من تصاعد المؤشر ما لم يُفعّل خيار التصفير).

Request Information

URI Parameters

None.

Body Parameters

Name	Description	Type	Additional information
ID	معرّف القراءة (فارغ عند الإضافة).	globally unique identifier	None.
CycleGuid	معرّف الدورة (مطلوب).	globally unique identifier	None.
ReadTime	وقت القراءة (مطلوب).	date	None.
MeterRead	مؤشر عدّاد الإنتاج التراكمي (مطلوب).	decimal number	None.
FuelConsumed	الوقود المستهلك في الساعة (لتر).	decimal number	None.
LoadValue	الحمل (A).	decimal number	None.
LoadKw		decimal number	None.
Voltage	الفولت (V).	decimal number	None.
Frequency	التردد.	decimal number	None.
Rpm	الدورات (RPM).	decimal number	None.
Battery	جهد البطارية.	decimal number	None.
Temperature	الحرارة.	decimal number	None.
OilPressure	ضغط الزيت.	decimal number	None.
L1	الطور الأول L1.	decimal number	None.
L1Kw		decimal number	None.
L2	الطور الثاني L2.	decimal number	None.
L2Kw		decimal number	None.
L3	الطور الثالث L3.	decimal number	None.
L3Kw		decimal number	None.
IsReset	تصفير/تبديل العداد (يتخطّى فحص تصاعد المؤشر).	boolean	None.
Note	ملاحظات.	string	None.
Image		Collection of byte	None.

Request Formats

application/json, text/json

Sample:

{
  "ID": "2f840ee1-b902-4522-a5ae-647530af0d8e",
  "CycleGuid": "619f5621-112b-4896-a415-a24f54bb0765",
  "ReadTime": "2026-11-15T02:22:19.7468823+03:00",
  "MeterRead": 1.0,
  "FuelConsumed": 1.0,
  "LoadValue": 1.0,
  "LoadKw": 1.0,
  "Voltage": 1.0,
  "Frequency": 1.0,
  "Rpm": 1.0,
  "Battery": 1.0,
  "Temperature": 1.0,
  "OilPressure": 1.0,
  "L1": 1.0,
  "L1Kw": 1.0,
  "L2": 1.0,
  "L2Kw": 1.0,
  "L3": 1.0,
  "L3Kw": 1.0,
  "IsReset": true,
  "Note": "sample string 2",
  "Image": "QEA="
}

application/xml, text/xml

Sample:

<HourlyReadModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
  <Battery>1</Battery>
  <CycleGuid>619f5621-112b-4896-a415-a24f54bb0765</CycleGuid>
  <Frequency>1</Frequency>
  <FuelConsumed>1</FuelConsumed>
  <ID>2f840ee1-b902-4522-a5ae-647530af0d8e</ID>
  <Image>QEA=</Image>
  <IsReset>true</IsReset>
  <L1>1</L1>
  <L1Kw>1</L1Kw>
  <L2>1</L2>
  <L2Kw>1</L2Kw>
  <L3>1</L3>
  <L3Kw>1</L3Kw>
  <LoadKw>1</LoadKw>
  <LoadValue>1</LoadValue>
  <MeterRead>1</MeterRead>
  <Note>sample string 2</Note>
  <OilPressure>1</OilPressure>
  <ReadTime>2026-11-15T02:22:19.7468823+03:00</ReadTime>
  <Rpm>1</Rpm>
  <Temperature>1</Temperature>
  <Voltage>1</Voltage>
</HourlyReadModel>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

ApiResult

Name	Type	Additional information
Error	integer	None.
Message	string	None.
Data	Object	None.

Response Formats

application/json, text/json

Sample:

{
  "Error": 1,
  "Message": "sample string 2",
  "Data": {}
}

application/xml, text/xml

Sample:

<ApiResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Core.Common">
  <Data />
  <Error>1</Error>
  <Message>sample string 2</Message>
</ApiResult>