GlobalGiving的API是宁静的在自然界中又需要用户去建构统一资源标识符(uri),它将以指定的格式返回所请求的数据。
作为一个例子,请尝试得到的主题API操作,通过访问以下URL返回GlobalGiving的所有主题,在这些主题下,项目被分类:
https: / / api.globalgiving.org/api/public/projectservice/themes ? api_key = 658137 f6 - ecaa - 4587 - 8701 - cc692cb9b153
在上面的例子中,首先要注意的是GlobalGiving API操作使用的是HTTPS协议。这确保了所有敏感数据,例如提交捐赠.
https://api.globalgiving.org/api/public/projectservice/themes?api_key = 658137 f6 - ecaa - 4587 - 8701 - cc692cb9b153
几乎所有的API操作都至少需要一个api_key查询字符串参数。唯一的例外是获取访问令牌操作中api_key,而是嵌入到发布的XML或JSON数据中。
查询字符串参数构成URL的一部分,包含GlobalGiving API操作期望和将要处理的数据。
访问上述示例时URL在浏览器中,由于没有指定响应类型,结果将以默认的XML格式返回。要将响应格式更改为JSON,需要一个客户机,例如cURL,其中接受头可以指定,必须使用。
响应可以格式化为XML“接受:application / xml”或JSON接受:application / json的.
类似地,在发布数据时,例如访问获取访问令牌或提交捐款方法指定数据发送的格式内容头。
请求数据可以作为XML发送“内容类型:应用程序/ xml”或JSON“application / json内容类型:.