refactor: fetch API endpoint catalog on demand and harden apify api

Download https://docs.apify.com/api/openapi.json at runtime when
--list-endpoints is used, instead of bundling a pre-generated
api-endpoints.json. Drops the prepack fetch step and the fetch-api-endpoints
script so the list can no longer go stale between releases.

While here, address staff-review findings on the apify api command:

- ^v2\/? could over-strip paths like "v2things/x"; require a trailing slash
  and accept it case-insensitively.
- --body was silently sent on GET/HEAD, triggering an unfriendly fetch
  TypeError. Reject early with a clear validation message.
- Custom headers could duplicate Content-Type due to case differences; apply
  overrides case-insensitively.
- On non-2xx responses, write the JSON response body to stdout (matches
  gh api) so pipelines like `apify api ... | jq` still receive the payload;
  status line stays on stderr.
- Document the one-header-per-invocation restriction in --header.
- Reset process.exitCode in beforeEach and capture actorId before
  assertions so the api-tests don't pass on inherited state or leak actors
  when an assertion fails.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: patrikbraborec

docs/reference.md

@@ -78,7 +78,9 @@ FLAGS
                          "-" to read from stdin.
       -H, --header=<value>   Additional HTTP header(s). Pass a
                          single "key:value" string, or a JSON object like '{"X-Foo":
-                         "bar", "X-Baz": "qux"}' to send multiple headers.
+                         "bar", "X-Baz": "qux"}' to send multiple headers. The flag
+                         can only be used once; use the JSON form for multiple
+                         headers.
   -l, --list-endpoints   List all available Apify API
                          endpoints.
       -X, --method=<option>  The HTTP method to use. Defaults to

package.json

@@ -17,10 +17,9 @@
         "format": "biome format . && prettier --check \"**/*.{md,yml,yaml}\"",
         "format:fix": "biome format --write . && prettier --write \"**/*.{md,yml,yaml}\"",
         "clean": "rimraf dist",
-        "fetch-api-endpoints": "tsx scripts/fetch-api-endpoints.ts",
         "build": "yarn clean && tsc && tsup",
         "build-bundles": "bun run scripts/build-cli-bundles.ts",
-        "prepack": "yarn insert-cli-metadata && (yarn fetch-api-endpoints || echo 'Warning: Failed to fetch API endpoints, using existing file') && yarn build && yarn update-docs",
+        "prepack": "yarn insert-cli-metadata && yarn build && yarn update-docs",
         "insert-cli-metadata": "tsx scripts/insert-cli-metadata.ts",
         "update-docs": "tsx scripts/generate-cli-docs.ts",
         "postinstall": "node -e \"console.log('We have an active developer community on Discord. You can find it on https://discord.gg/crawlee-apify-801163717915574323.');\"",