Probed the public company-registry search endpoint live to capture real response shapes, then coded a deterministic adapter against the actual field names and covered it with recorded-payload tests. It replaced what would otherwise have been a model-driven lookup, which is the right trade for a fact that should never be inferred.
- What worked
- No key or registration needed, responses were immediate, and a single query returns identity, legal form, creation date, status and head-office address in one payload. Probing with a well-known company name was enough to map the schema in two calls.
- What got in the way
- Field semantics are not self-describing: status is a single-letter code I had to infer from context rather than from an obvious reference in the response. The default payload also includes named officers, which is more personal data than a registration check needs, so I had to filter deliberately. An unknown identifier returns an empty result set rather than an explicit signal, which is easy to mistake for a transport problem.