方案管理：创建、修改，终止_第三方云接入

创建合约

Request

HTTP request (graphql)

POST https://vsaas-domain/vsaas/api/v1/ss/contract 

参数

Header

Authorization : Bearer {Oauth token}

The access token.

Content-Type : application/json

Required

参数	类型	必选	说明
account	String	是	用户的email或者手机号，格式如下：base64("{"email":"12345666"}）
productId	String	是	plan id
transactionId	String	是	支付订单编号
note	String	否
purpose	String	否	如果合约是跟设备的，则需要在此字段填入设备UID；如果是跟账号的，不需要填入UID。
payment_type	int	否	只做内部记录用，TUTK不做其他处理

Response

参数	类型	说明
data	json object
contractId	String	合约id
expires	String	到期时间

Code

200

400

401

例子

Request

curl -X POST \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Oauth token>' \
-d '{"account":"ewoJImVtYWlsIjogIjEwMDE3ODY1Igp9","productId":"fsajhfkjahfkjasdhfsakfha","purpose":"UUUUUUUUUUUUUUUUUUUU"}' \
https://vsaas-domain/vsaas/api/v1/ss/contract

Response

{
    "data": {
        "contractId": "66fa0056f35e358c2arewrqggg",
        "expires": "2024-02-30T01:35:18.312174281Z",
        "startTime": "2024-01-30T01:35:18.312174281Z"
    }
}

修改合约

Request

HTTP request

PATCH http://vsaas-domain/vsaas/api/v1/ss/contract/{id}

参数

Header

Authorization : Bearer {Oauth token}

The access token.

Content-Type : application/json

Required

参数	类型	必选	说明
id	String	是
state	String	是	"cancel" or "activate"，想要更改的状态。“activate”表示合同将延长至下一个到期日。“cancel”表示合同将立即终止。

Response

参数	类型	说明
data	json object
contractId	String
expires	String

Code

200

400

401

例子

Request

curl -X PATCH \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Oauth token>' \
-d '{"state":":"cancel"}' \
http://vsaas-domain/vsaas/api/v1/ss/contract/93FEE01553D71FE0AA0F

Response

{
        "data": {
            "contractId": "<Contract id>",
            "expires": "<Expiration UTC time>"
        }
}

删除合约

Request

HTTP request

DELETE http://vsaas-domain/vsaas/api/v1/ss/contract/{id}

参数

Header

Authorization : Bearer {Oauth token}

The access token.

Content-Type : application/json

Required

参数	类型	必选	说明
id	String	是

参数	类型	说明
data	json object
message	String

Code

200

400

401

例子

Request

curl -X DELETE \ 
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Oauth token>' \
http://vsaas-domain/vsaas/api/v1/ss/contract/93FEE01553D71FE0AA0F

Response

{
    "data": {
        "message": "Terminate contract success."
    }
}