通過DocumentId查找信封？

Question

我剛剛開始使用DocuSign REST API（創建與我公司產品的概念證明集成），並試圖將我的頭圍繞一切。有一對夫婦的事情，我無法找到很多信息：

1. 當創建一個信封，並在documentId事？我假設如果有多個文檔，每個文檔的documentId需要不同。它在其他地方使用嗎？

2. 定期地，我想檢查一個信封的審計事件。如果我可以使用documentId來查找信封（或直接進入審計事件而不查看信封），那將會容易得多。這可能嗎？

我們的產品已經存儲的文件，因此具有documentId - 所以這是創建信封時，我使用的ID。我想要做的是，無論我在產品中查看的任何文檔是否有未完成的信封都處於待定狀態，請檢查。然後，我不需要在我們的系統中存儲任何DocuSign相關數據（即envelopeId）。

我可以通過documentId查找用於創建它的信封嗎？

Answer 1

1. 的documentId是一個客戶端定義的屬性和僅僅是有幫助你標記被用於給信封的文件。如果您想跟蹤您在信封中提供的文檔（聽起來像您），那麼您可以使用它來唯一標識基礎文檔，並且如果您已經有一個生成了documentIds的系統，那麼應該事情更容易。

2. 不，沒有辦法通過documentId檢索信封信息。最好的解決方案是最有可能存儲一個簡單的表格，鏈接documentIds到envelopeIds，然後給出documentId您要搜索使用鏈接的envelopeId來檢索其狀態。

但是，您應該注意，某些API調用存在某些API調用限制，並且請求信封狀態爲其中之一。每15分鐘不得要求給定信封的狀態超過1次。相反，如果您想跟蹤實時狀態，建議使用DocuSign Connect模塊（DocuSign Connect會在發生這種情況時立即向您推送狀態，而不是每隔一段時間輪詢一次狀態）。

有關API調用限制的詳細信息中下圍棋直播部分的DocuSign開發者中心檢查出的API最佳實踐文檔： https://www.docusign.com/developer-center/go-live/certification