POST api/ValueCard/OneOf/Type/AddOrUpdate

添加或修改一个一次性储值卡类型。 需要判断返回值,返回值的errcode为0表示成功,其他值表示错误。

Request Information

URI Parameters

None.

Body Parameters

添加或修改一次性储值卡类型的参数。

OneOfValueCardUpdateParm
NameDescriptionTypeAdditional information
OP

操作类型,I表示新增,U表示修改。

string

Required

Max length: 1

Min length: 1

ValueCardTypeId

储值卡类型ID ValueCardTypeId Char(4) PK,NN

string

Required

Max length: 4

Min length: 4

ValueCardTypeName

储值卡名称 ValueCardTypeName Varchar(40) NN,UN 示例:2020年度一次性儿童储值卡

string

Required

Max length: 40

Denomination

面值 Denomination Numeric(18,2) NN

decimal number

Required

LeaderCharacter

前导字符 LeaderCharacter Char(4) NN,UN 前导字符

string

Required

Max length: 4

Min length: 4

OneTicketOnly

是否仅能兑换单一票型 OneTicketOnly Char(1) NN 1-是,0-否。

string

Required

Max length: 1

Min length: 1

TicketTypeId

票型ID Uniqueidentifier 门票类型的ID,当OneTicketOnly=‘1’时,此值不能为空。

globally unique identifier

None.

ValidCalType

有效期类型 ValidCalType Char(1) NN 计算有效期的方式,1表示自发放之日起,有效期长度的日数内有效;2表示有效期延续至指定的日期。

string

Required

Max length: 1

Min length: 1

ValidLength

有效期长度(单位日) ValidLength Int 当ValidCalType =“1“时,此值必须指定,且必须大于1;当ValueCalType=’2’时,此值没意义。

integer

None.

ValidEndDate

有效期至 ValidEndDate Char(8) 当ValidCalType=’2’时,此值必须指定,表示不论什么时候注册,至这个日期均过期。格式YYYYMMDD。

string

None.

BL1

保留一 BL1 Varchar(50)

string

None.

BL2

保留二 BL2 Varchar(50)

string

None.

Request Formats

application/json, text/json

Sample:
{
  "OP": "sample string 1",
  "ValueCardTypeId": "sample string 2",
  "ValueCardTypeName": "sample string 3",
  "Denomination": 4.0,
  "LeaderCharacter": "sample string 5",
  "OneTicketOnly": "sample string 6",
  "TicketTypeId": "de455d58-49fe-4a34-ad89-e4641dd96b7b",
  "ValidCalType": "sample string 8",
  "ValidLength": 9,
  "ValidEndDate": "sample string 10",
  "BL1": "sample string 11",
  "BL2": "sample string 12"
}

application/xml, text/xml

Sample:
<OneOfValueCardUpdateParm xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Parm.ValueCard">
  <BL1>sample string 11</BL1>
  <BL2>sample string 12</BL2>
  <Denomination>4</Denomination>
  <LeaderCharacter>sample string 5</LeaderCharacter>
  <OP>sample string 1</OP>
  <OneTicketOnly>sample string 6</OneTicketOnly>
  <TicketTypeId>de455d58-49fe-4a34-ad89-e4641dd96b7b</TicketTypeId>
  <ValidCalType>sample string 8</ValidCalType>
  <ValidEndDate>sample string 10</ValidEndDate>
  <ValidLength>9</ValidLength>
  <ValueCardTypeId>sample string 2</ValueCardTypeId>
  <ValueCardTypeName>sample string 3</ValueCardTypeName>
</OneOfValueCardUpdateParm>

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

添加或修改一个一次性储值卡类型。 需要判断返回值,返回值的errcode为0表示成功,其他值表示错误。

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.