fix: more intro

specs/crawler/spec.yml

@@ -30,6 +30,26 @@ info:
     You can find both in the [Crawler dashboard](https://crawler.algolia.com/admin/settings/).
     The Crawler dashboard and API key are different from the regular Algolia dashboard and API keys.
 
+    # Request format
+
+    Request bodies must be JSON objects.
+
+    # Parameters
+
+    Parameters are passed as query parameters for GET requests,
+    and in the request body for POST and PATCH requests.
+
+    Query parameters must be [URL-encoded](https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding).
+    Non-ASCII characters must be UTF-8 encoded.
+
+    # Response status and errors
+
+    The Crawler API returns JSON responses.
+    Since JSON doesn't guarantee any specific ordering, don't rely on the order of attributes in the API response.
+
+    Successful responses return a `2xx` status. Client errors return a `4xx` status. Server errors are indicated by a `5xx` status.
+    Error responses have a `message` property with more information.
+
     # Version
 
     The current version of the Crawler API is version 1, as indicated by the `/1/` in each endpoint's URL.