簡體   English   中英

與C#開發人員就API中的錯誤進行溝通的最佳方法是什么?

[英]Whats the best way to communicate with C# developers about bugs in their API?

我正在測試由C#開發人員編寫的API。 我是Perl開發人員。 因此,我想使用一種與語言無關的方式向他們發送錯誤報告。 對於GET請求,這很簡單(除非涉及標頭)。 但是對於POST則不是。

如今,許多記錄API的站點在其文檔中都使用curl命令,以提供與語言無關的示例。 例如Stripe

在Unix或OSX世界中,我會向他們發送curl命令,並說當您運行此命令時,響應會以某種方式中斷。 但是curl不是Windows固有的(盡管它可以在Windows上安裝並運行)。 C#開發人員是否了解curl? 他們會卷曲嗎? 我認為將它們推送到命令行並不感到興奮,但是我想不出一種更好的方式來談論這些事情。 有什么建議么?

但是對於POST則不是。

為什么? 最后,GET和POST是HTTP。 通過發送的標頭發送,而不是通過API調用發送。

C#開發人員是否了解curl?

我不是。 我不接受此類錯誤報告。 但是我很樂意接受HTTP有效負載作為轉儲。

我認為將它們推送到命令行並不激動,

我不認為在命令行上會推卷曲。 我認為它被推到了我不喜歡安裝的工具上。 我一直都在使用命令行-哎呀,我維護着一些大多數人通過命令行使用的軟件。

Windows中僅命令行是PowerShell。

不要使用卷曲。 對於大多數C#程序員而言,它離Unix-y還很遠。 通常,它將需要某種命令行轉義約定,並且這也不是可移植的。 這將不受歡迎。

在錯誤報告中以純文本格式提供確切的HTTP調用/請求順序,我沒有發現任何問題。

  1. 任何人都可以以完全與語言無關的方式閱讀它。
  2. 剪切和粘貼片段進行試用相對容易。
  3. 如果有人對您的錯誤報告足夠感興趣,那么很容易編寫一個小的工具將其轉換為C#可以處理的東西,Powershell甚至是curl。

[碰巧我在Windows中使用C#,curl甚至wget都非常開心,但是我的回答仍然成立。]

暫無
暫無

聲明:本站的技術帖子網頁,遵循CC BY-SA 4.0協議,如果您需要轉載,請注明本站網址或者原文地址。任何問題請咨詢:yoyou2525@163.com.

 
粵ICP備18138465號  © 2020-2024 STACKOOM.COM