票证vs请求api:如何为项目选择正确的选项

在Support API中而且请求亚博电脑端资源似乎提供了许多相同的功能。虽然有一些相似之处,但它们之间都有重要的区别。选择正确的端点可以为您省去很多麻烦。本文将阐明几个主要的区别,帮助您为项目选择正确的选项。

请注意,当在本文中将Tickets和Requests大写时,它们指的是Support API中的相关资源。亚博电脑端

关键的不同点

两者之间的主要区别是Requests旨在由最终用户或代表使用,而Tickets旨在由代理和管理员或代表使用。

在选择这些API资源时,您的第一个问题应该是“亚博电脑端这个项目是为代理还是最终用户构建的”。基于这个答案,开始为你的听众提供预期的资源。

以下是这两种资源之间最重要的区别:亚博电脑端

关于票证创建

  • 票总是需要代理身份验证。请求可以通过代理、管理员或最终用户的身份验证提交,而不需要匿名用户的身份验证。要了解关于未经身份验证提交请求的详细信息,请参见创建匿名请求在开发者文档中。
  • 门票只需要“comment”属性。请求要求“主题”和“评论”。此外,匿名请求还需要具有“name”属性的“requester”对象。
    • 所需示例票证有效载荷:
      •                    
        “票”“评论”“身体”“我是一个评论!”
    • 例子需要通过身份验证请求负载:
      •                    
        “请求”“主题”“我是臣民!”“评论”“身体”“我是一个评论!”
    • 例子需要匿名请求负载:
      •                    
        “请求”“请求者”“名称”“我是请求者!”“主题”“我是臣民!”“评论”“身体”“我是一个评论!”

关于机票更新

  • 票证允许更新广泛的票证属性.请求只允许添加注释、添加cc或将票据设置为已解决的状态。匿名用户不允许通过任一端点更新票证。

其他

  • 任何批量或“创建多个”操作只能通过Tickets执行。

结论

尽管在这两个端点中都有类似的行为,但您现在可以看到它们有两个不同的目的。如果你有任何其他不同的情况,或者如果你有问题,请在下面留下评论!