获取礼券详情

注意:您必须输入sign the服务条款使用此API特性的协议。请下载，在此签署并以电子邮件形式发送一份服务条款协议副本，然后返回至api@globalgiving.org启用此功能。您必须证明您将处理捐献者的输入和数据符合pci dss处理敏感信息时的标准。这主要意味着确保你的连接是HTTPS，你的服务器是安全的，并且你从不存储用户的信用卡信息。

通过该操作，用户可以查询礼品券的有效期和详细信息。操作步骤

HTTP方法:

得到

内容类型:

xml、json

接受类型:

xml、json

路径:

https://api.globalgiving.org/api/secure/givingservice/giftcertificatedetail/ {giftcertid} /

路径参数:

giftcertid请核对礼券号码

查询字符串参数:

api_key在API密匙部分,需要

查询字符串示例:

/ api /安全/ givingservice / giftcertificatedetail / GXYZ12345678吗?api_key = YOUR_API_KEY

数据参数:

没有一个

HTTP获取请求示例，使用cURL

curl -H "Accept: application/xml" -H "Content-Type: application/xml" -X GET "https://api.globalgiving.org/api/secure/givingservice/giftcertificatedetail/GXYZ123456789?api_key=YOUR_API_KEY"

注意:为了可读性，以上请求有回车。

XML响应:

<？XML版本="1.0" encoding="utf-8" standalone="yes"?>  USD 2020-12-31T23:59:59-04:00 GZTKACJEA0Q46 25.00 true

获取礼券详细信息响应结构

giftCertificate_detail

currencyCode	字符串
expirationDate	dateTime
giftCertificateNumber	字符串
remainingAmount	小数
有效的	布尔

获取礼券详细信息响应的元素定义

元素	强制性的	描述
currencyCode	要求	礼品券金额的货币。
expirationDate	要求	过期的日期——礼券是好的通过美国东部时区的截止日期。
giftCertificateNumber	要求	将是传递到查询中的相同giftcertid。
remainingAmount	要求	商品券上剩余的金额。
有效的	要求	快速确定证书是否有效的方法。如果证书已被系统管理员无效，或者过期日期已过期，或者remainingBalance已过期，则该值为false