You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<p>ESS guarantees at least once event delivery. This is accomplished through the retry posting the event payload to the subscribers’ endpoint until the response indicates successful receipt. The expected maximum acknowledgment time for a request to the subscribers’ endpoint is 30 seconds. The service will attempt posting to the endpoint and then hold and retry until the subscriber endpoint responds with delivered or not accepted. The service will retry at least 3 days and skip to the next event after unsuccessful delivery. We suggest that the subscriber consider following:</p>
1361
+
<p>ESS guarantees at least once event delivery. This is accomplished through the retry posting the event payload to the subscribers’ endpoint until the response indicates successful receipt. The expected maximum acknowledgment time for a request to the subscribers’ endpoint is 60 seconds. The service will attempt posting to the endpoint and then hold and retry until the subscriber endpoint responds with delivered or not accepted. The service will retry at least 3 days and skip to the next event after unsuccessful delivery. We suggest that the subscriber considers the following:</p>
1362
1362
1363
1363
<ul>
1364
-
<li>Endpoint response time requirements depend on the topic throughput. Please review the topic documentation for throughput.</li>
1364
+
<li>Expected maximum throughput is <em>directly</em> tied to the response time of the subscriber endpoint. If response time is too high, it’s possible that the subscriber falls behind on event delivery. Please review the topic documentation for throughput.</li>
1365
+
<li>Even though we permit up to a maximum response time of 60 seconds before timing out & retrying, that should not be considered a suggestion. In most cases, the subscriber endpoint response time will need to be measured in just a few seconds <em>at most</em> in order to keep up with event traffic.</li>
1365
1366
<li>It is highly recommended to implement a queue behind the subscriber’ endpoint in order to keep response time as low as possible.</li>
1366
1367
<li>The subscriber must maintain a reasonable uptime to support the requirements of the integration scenario.</li>
1367
1368
<li>Your HTTPS server endpoint must be accessible from the public web with a non-self-signed certificate. The certificate should be signed by a known Certificate Authority and should be reachable through DNS.</li>
<li>Requests will come from <codeclass="language-plaintext highlighter-rouge">us.api.concursolutions.com</code>, <codeclass="language-plaintext highlighter-rouge">emea.api.concursolutions.com</code>, or <codeclass="language-plaintext highlighter-rouge">cn.api.concursolutions.com</code>.</li>
1406
1407
<li>Connection will always be established using a mutual TLS with <codeclass="language-plaintext highlighter-rouge">webhook.api.concursolutions.com</code> x509 certificate.</li>
1407
1408
<li>Requests will always have a digital signature.</li>
1408
-
<li>Requests will be re-tried when the subscriber responds with HTTP Response Code(s): 5xx, 401, 403, or 429.</li>
1409
-
<li>Requests will not be re-tried when subscriber responds with HTTP Response Code(s):
1409
+
<li>Requests <em>will</em> be re-tried when:
1410
+
<ul>
1411
+
<li>the subscriber endpoint responds with HTTP Response Code(s): 5xx, 401, 403, or 429.</li>
1412
+
<li>any I/O error occurs during the HTTP request, regardless of the actual HTTP response from the subscriber endpoint.
1413
+
<ul>
1414
+
<li>examples include, but are not limited to: read timeout, connection refused, broken pipe/unexpected connection close, etc.</li>
1415
+
</ul>
1416
+
</li>
1417
+
</ul>
1418
+
</li>
1419
+
<li>Requests <em>will not</em> be re-tried when subscriber endopint responds with HTTP Response Code(s):
1410
1420
<ul>
1411
1421
<li>2xx – Indicates successful receipt of the event.</li>
1412
1422
<li>4xx – Indicates posted event is unexpected or incorrectly formatted.</li>
0 commit comments