Merge pull request DataDog#11017 from DataDog/margot.lepizzera/or_guide

cswatt · web-flow · commit 49b9b23a7859 · 2021-07-08T10:34:26.000-04:00
Create or-logic-api-tests-assertions.md
diff --git a/content/en/synthetics/guide/_index.md b/content/en/synthetics/guide/_index.md
@@ -12,6 +12,10 @@ private: true
     {{< nextlink href="synthetics/guide/synthetic-tests-caching" >}}Avoiding cache issues in Synthetic tests{{< /nextlink >}}
 {{< /whatsnext >}}
 
+{{< whatsnext desc="API Tests:" >}}
+    {{< nextlink href="synthetics/guide/or-logic-api-tests-assertions" >}}Perform OR logic in API test assertions{{< /nextlink >}}
+{{< /whatsnext >}}
+
 {{< whatsnext desc="Browser Tests:" >}}
     {{< nextlink href="synthetics/guide/browser-test-self-maintenance/" >}}Why are browser tests self-maintaining?{{< /nextlink >}}
     {{< nextlink href="synthetics/guide/app-that-requires-login/" >}}Monitor an application that requires authentication{{< /nextlink >}}
diff --git a/content/en/synthetics/guide/or-logic-api-tests-assertions.md b/content/en/synthetics/guide/or-logic-api-tests-assertions.md
@@ -0,0 +1,26 @@
+---
+title: Perform OR logic in API tests assertions
+kind: guide
+further_reading:
+    - link: '/synthetics/api_tests'
+      tag: 'Documentation'
+      text: 'Create an API Test'
+    - link: '/synthetics/multistep'
+      tag: 'Documentation'
+      text: 'Create a Multistep API Test'
+    - link: "/getting_started/synthetics/api_test"
+      tag: "Documentation"
+      text: "Get started with HTTP tests"
+---
+
+You can perform `OR` logic on your [API test][1] assertions to define several different expected values for the same assertion type. For example, you may want your [HTTP test][2] `status code` assertion to succeed in case your server responds with a `200` **or** with a `302`.
+
+To do this, you can use the [`matches regex` comparator][3] and define a regex like `(200|302)`. With such an assertion, your test result is successful if the status code returned by the server is 200 **or** 302.
+
+## Further Reading
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: /synthetics/api_tests/
+[2]: /synthetics/api_tests/http_tests/
+[3]: /synthetics/api_tests/http_tests/?tab=requestoptions#define-assertions
