Skip to content

Commit c9f7e0e

Browse files
[skip ci] Updates
1 parent 5167b62 commit c9f7e0e

File tree

2 files changed

+16
-6
lines changed

2 files changed

+16
-6
lines changed

api-reference/ess/v4.event-subscription.html

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1358,10 +1358,11 @@ <h2 id="ess-delivery-model-">ESS Delivery Model <a name="ess-delivery"></a></h2>
13581358

13591359
<h2 id="endpoint-requirements-">Endpoint Requirements <a name="endpoint-requirements"></a></h2>
13601360

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 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>
13621362

13631363
<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 &amp; 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>
13651366
<li>It is highly recommended to implement a queue behind the subscriber’ endpoint in order to keep response time as low as possible.</li>
13661367
<li>The subscriber must maintain a reasonable uptime to support the requirements of the integration scenario.</li>
13671368
<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>
@@ -1405,8 +1406,17 @@ <h2 id="ess-behavior">ESS Behavior<a name="ess-behavior"></a></h2>
14051406
<li>Requests will come from <code class="language-plaintext highlighter-rouge">us.api.concursolutions.com</code>, <code class="language-plaintext highlighter-rouge">emea.api.concursolutions.com</code>, or <code class="language-plaintext highlighter-rouge">cn.api.concursolutions.com</code>.</li>
14061407
<li>Connection will always be established using a mutual TLS with <code class="language-plaintext highlighter-rouge">webhook.api.concursolutions.com</code> x509 certificate.</li>
14071408
<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):
14101420
<ul>
14111421
<li>2xx – Indicates successful receipt of the event.</li>
14121422
<li>4xx – Indicates posted event is unexpected or incorrectly formatted.</li>

feed.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@
55
<description>Concur docs provides comprehensive information on working with the Concur platform</description>
66
<link>https://preview.developer.concur.com/</link>
77
<atom:link href="https://preview.developer.concur.com/feed.xml" rel="self" type="application/rss+xml" />
8-
<pubDate>Tue, 21 Oct 2025 18:35:27 +0000</pubDate>
9-
<lastBuildDate>Tue, 21 Oct 2025 18:35:27 +0000</lastBuildDate>
8+
<pubDate>Wed, 29 Oct 2025 19:13:06 +0000</pubDate>
9+
<lastBuildDate>Wed, 29 Oct 2025 19:13:06 +0000</lastBuildDate>
1010
<generator>Jekyll v4.1.1</generator>
1111

1212
</channel>

0 commit comments

Comments
 (0)