当请求成功时,web服务返回一个HTTP 2xx响应代码。
HTTP成功代码:
成功的代码 | 消息 | 描述 |
---|---|---|
200 | 好吧 | 成功接收请求。 |
web服务应该在60秒内返回响应。如果请求超时而没有响应,应用程序应该等待5分钟,然后重试请求。
当出现任何错误时,web服务将返回一个4xx或5xx HTTP响应代码,并将包括以下元素:
元素 | 描述 |
---|---|
StatusCode | HTTP错误码。 |
内容 | 包含错误子元素。 |
元素 | 描述 |
---|---|
消息 | 错误消息。 |
服务器时间 | 根据SAP Concur服务器的时区生成错误的时间。 |
Id | 在Concur中错误的ID。 |
有关特定于函数的错误格式,请参阅单个函数文档。
可以找到可能的HTTP错误代码的完整列表在这里.下表提供了常见错误代码的额外详细信息。
错误代码 | 消息 | 描述 |
---|---|---|
400 | 坏的请求 | 如果其中任何一个条件为真,则返回此响应: *指定的URI无效。 *请求格式不正确。 请求缺少一个必填字段。 *收到的请求数量超过了请求限制。 *请求遇到数据库死锁。在这种情况下,开发人员应该在短时间后重新发送请求。 *如果开发者的web服务器启用了Chunked Transfer-Encoding,则会收到此错误。Concur不支持分块传输编码。 与会者Web服务: *批操作的URI中不包含批类型参数。 *请求包含0个参会者。 *请求包含超过1000名与会者。 成像Web服务: *条码或reporttid丢失。 采购订单Web服务: *请求包含0个购买订单。 *请求包含超过1000个采购订单。 列表项Web服务: *请求包含0个列表项。 *请求包含超过1000个列表项。 付款批处理文件: * URI中指定的批处理ID无效。 旅行批准: *请求包含0个行程。 用户的Web服务: *请求包含0个用户。 *请求包含超过1000个用户。 |
401 | 未经授权的 | 请求中不包含授权头。 |
403 | 被禁止的 | 如果其中任何一个条件为真,则返回此响应: *包含了授权头,但验证失败。如果OAuth消费者不能访问web服务所需的Concur产品,就会发生这种情况。 *与oauth_consumer_key关联的合作伙伴应用程序未被允许访问请求的公司。 * Oauth令牌已过期或已被撤销。 |
404 | 没有找到 | 提取Web服务: URI中指定的定义ID或作业ID无效。 成像Web服务:没有为指定的报告Id或条形码找到图像。 行程Web服务: URI中指定的Trip ID或Booking ID无效。 支付批处理Web服务: URI中指定的批处理ID无效。 |
409 | 冲突 | 提取Web服务:指定定义的作业已经排队或正在运行。 |
429 | 太多的请求 | 当服务因来自单一源的过多请求或聚合的过多请求而过载时,将返回此响应。当这种情况发生时,会降低请求的速度。 |
500 | 内部服务器错误/未关闭 | 费用报告Web服务:当系统无法计算已过费用报告条目的汇率时,将返回此响应。 支付批处理Web服务:指定的批无法关闭。 |
503 | 服务不可用 | 此响应在web服务为维护而关闭时返回。合作伙伴应用程序应该休眠5分钟,然后重试请求。如果请求在几次重试后仍然失败,开发人员应该联系concurconnecttech@concur.com。 |