Write Card

Last Updated on : 2025-05-28 10:14:26download

Based on the effective time and the expiry time, send a card writing command to a card issuer, in order to write the data to a specified card.

API address

POST: /v1.0/osaas/projects/{project_id}/card-issue-devices/card-issuer/{device_id}/card-info-write

Request parameter

Parameter name	Type	IN	Required	Description
project_id	String	uri	true	The unique ID of a specified project.
device_id	String	uri	true	The unique ID of a specified device.
request	IssuingWriteCardRequest		false	The request of writing the data to a specified card.

Description of request

Parameter name	Type	IN	Required	Description
begin_time	Long		false	The time when a card takes effect.
end_time	Long		false	The time when a card expires.

Return parameter

Parameter name	Type	Description
result	IssuingWriteCardResponse	The returned result of writing the data to a card.

Description of result

Parameter name	Type	Description
operate_id	String	The unique ID of the operation.
operate_result	Boolean	The operation result.
card_id	String	The unique ID of a specified card.

Request example

POST: /v1.0/osaas/projects/150188910571223***/card-issue-devices/card-issuer/6c470253258246b99****/card-info-write

{
  "beginTime": 1658303985000,
  "endTime": 1666252785000
}

Return example

{
    "tid": "aae3ead40e3a11ed818882d0e***",
    "result": {
        "operate_id": "1552534592777359***",
        "operate_result": true,
        "card_id": "15525345928151***"
    },
    "t": 1658988066464,
    "success": true
}

Error code

For more information, see error code.