fix(client): return Detail on non-JSON 2xx for api_tokens and honeytoken-with-context

benjaminrigaud-gg · benjaminrigaud-gg · commit 2695fd9010ea · 2026-06-22T16:36:46.000+02:00
api_tokens() and create_honeytoken_with_context() guarded JSON parsing
with a bare resp.ok, so a 2xx response with a non-JSON body (e.g. an HTML
page served when the instance URL is wrong) crashed callers with a raw
JSONDecodeError instead of returning a Detail.

Gate JSON parsing on the response status and content type via the
existing is_ok()/is_create_ok() helpers, matching every other endpoint,
so a non-JSON body falls through to load_detail() and a Detail is
returned. Fix the api_tokens success test to use the 200 the endpoint
actually returns.
diff --git a/changelog.d/20260622_163617_benjamin.rigaud_harden_api_tokens_non_json.md b/changelog.d/20260622_163617_benjamin.rigaud_harden_api_tokens_non_json.md
@@ -0,0 +1,3 @@
+### Fixed
+
+- `api_tokens()` and `create_honeytoken_with_context()` now return a `Detail` instead of raising a raw `JSONDecodeError` when the server answers a `2xx` with a non-JSON body (e.g. an HTML page served when the instance URL is wrong). Like the other endpoints, they now gate JSON parsing on the response status and content type.
diff --git a/pygitguardian/client.py b/pygitguardian/client.py
@@ -425,7 +425,7 @@ def api_tokens(
             result = Detail("The request timed out.")
             result.status_code = 504
         else:
-            if resp.ok:
+            if is_ok(resp):
                 result = APITokensResponse.from_dict(resp.json())
             else:
                 result = load_detail(resp)
@@ -741,7 +741,7 @@ def create_honeytoken_with_context(
             result = Detail("The request timed out.")
             result.status_code = 504
         else:
-            if resp.ok:
+            if is_create_ok(resp):
                 result = HoneytokenWithContextResponse.from_dict(resp.json())
             else:
                 result = load_detail(resp)
diff --git a/tests/test_client.py b/tests/test_client.py
@@ -1002,7 +1002,7 @@ def test_api_tokens(client: GGClient, token):
     mock_response = responses.get(
         url=client._url_from_endpoint(f"api_tokens/{token}", "v1"),
         content_type="application/json",
-        status=201,
+        status=200,
         json={
             "id": "5ddaad0c-5a0c-4674-beb5-1cd198d13360",
             "name": "myTokenName",
@@ -1049,6 +1049,28 @@ def test_api_tokens_error(
     assert isinstance(result, Detail)
 
 
+@responses.activate
+def test_api_tokens_non_json_body(client: GGClient):
+    """
+    GIVEN an api_tokens endpoint answering 200 with a non-JSON body
+        (e.g. the dashboard SPA's HTML, served when the instance URL is wrong)
+    WHEN calling api_tokens
+    THEN it returns a Detail instead of raising a raw JSONDecodeError
+    """
+    mock_response = responses.get(
+        url=client._url_from_endpoint("api_tokens/self", "v1"),
+        content_type="text/html",
+        status=200,
+        body="<!doctype html><html><body>GitGuardian</body></html>",
+    )
+
+    result = client.api_tokens()
+
+    assert mock_response.call_count == 1
+    assert isinstance(result, Detail)
+    assert result.status_code == 200
+
+
 @responses.activate
 def test_create_honeytoken(
     client: GGClient,
@@ -1189,6 +1211,32 @@ def test_create_honeytoken_with_context_error(
     assert isinstance(result, Detail)
 
 
+@responses.activate
+def test_create_honeytoken_with_context_non_json_body(client: GGClient):
+    """
+    GIVEN the honeytoken with-context endpoint answering 2xx with a non-JSON body
+    WHEN calling create_honeytoken_with_context
+    THEN it returns a Detail instead of raising a raw JSONDecodeError
+    """
+    mock_response = responses.post(
+        url=client._url_from_endpoint("honeytokens/with-context", "v1"),
+        content_type="text/html",
+        status=201,
+        body="<!doctype html><html></html>",
+    )
+
+    result = client.create_honeytoken_with_context(
+        name="honeytoken A",
+        description="honeytoken used in the repository AA",
+        type_="AWS",
+        filename="aws.yaml",
+    )
+
+    assert mock_response.call_count == 1
+    assert isinstance(result, Detail)
+    assert result.status_code == 201
+
+
 @responses.activate
 def test_create_jwt(
     client: GGClient,

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+### Fixed`
	`2`	`+`
	`3`	+- `api_tokens()` and `create_honeytoken_with_context()` now return a `Detail` instead of raising a raw `JSONDecodeError` when the server answers a `2xx` with a non-JSON body (e.g. an HTML page served when the instance URL is wrong). Like the other endpoints, they now gate JSON parsing on the response status and content type.