POST api/Sub/DataIdentifier/Add

向一个订阅中添加数据项。

Request Information

URI Parameters

None.

Body Parameters

SubcriberDataAddParm
NameDescriptionTypeAdditional information
SubscriberId

@ char(4),/*订阅的ID*/

 string

Required

Max length: 4

Min length: 4
DataEffectiveTimeLong

@ int ,/*数据有效时长 Int NN 单位秒，默认为300，表示最后一次抄读结果的有效时长，数据失败时停止报送且抄读回复失败。*/

 integer

Required
RptWithFreezedMode

@ Char(1),/*冻结状态下主动报送 NN 1表示是，0表示否。抄读报送不受此字段的约束。*/

 string

Required

Max length: 1

Min length: 1
RptWithFreezedInterval

@ int ,/*冻结状态下的报送时间间隔 Int 单位秒。在冻结状态下主动报送时的时间间隔。*/

 integer

None.
DataIds

@ as CT_STR50_UNIQUE_ARR READONLY /*数据标识符 DataId Char(10) PK */

 Collection of string

Required

Request Formats

application/json, text/json

Sample: 
{
  "SubscriberId": "sample string 1",
  "DataEffectiveTimeLong": 2,
  "RptWithFreezedMode": "sample string 3",
  "RptWithFreezedInterval": 1,
  "DataIds": [
    "sample string 1",
    "sample string 2"
  ]
}

application/xml, text/xml

Sample: 
<SubcriberDataAddParm xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Dosimeter">
  <DataEffectiveTimeLong>2</DataEffectiveTimeLong>
  <DataIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </DataIds>
  <RptWithFreezedInterval>1</RptWithFreezedInterval>
  <RptWithFreezedMode>sample string 3</RptWithFreezedMode>
  <SubscriberId>sample string 1</SubscriberId>
</SubcriberDataAddParm>

application/x-www-form-urlencoded

Sample:

Sample not available.

application/bson

Sample: 
Binary JSON content. See http://bsonspec.org for details.

Response Information

Resource Description

向一个订阅中添加数据项。

CommonOperationResult
NameDescriptionTypeAdditional information
errcode

错误代码，通常0表示成功，其他值表示错误。

 integer

None.
errmsg

错误描述，当errcode不为零时，此值可以用于呈现给用户。

 string

None.
tag

操作同时，服务器端需要返回的其他值。

 string

None.

Response Formats

application/json, text/json

Sample: 
{
  "errcode": 1,
  "errmsg": "sample string 2",
  "tag": "sample string 3"
}

application/xml, text/xml

Sample: 
<CommonOperationResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer">
  <errcode>1</errcode>
  <errmsg>sample string 2</errmsg>
  <tag>sample string 3</tag>
</CommonOperationResult>

application/bson

Sample: 
Binary JSON content. See http://bsonspec.org for details.