ClientProfile
: string
in package
Which security posture a client is registered under (X5.1). This is the FAPI "one switch".
FAPI 2.0 is not a single feature but a bundle of constraints — mandatory PAR, mandatory PKCE
with S256, mandatory strong client authentication, mandatory sender-constrained tokens,
and a refusal of every relaxation the base specs permit. Encoding them as one profile rather
than a dozen independent booleans means an operator cannot register a client that is
nearly FAPI, and a reviewer can answer "is this client financial-grade?" by reading one
field. The same philosophy as the rate-limit postures: ordinary clients see no behaviour
change at all, because Standard is the serde default and every row
written before schema v38 decodes to it.
An open enum. A value this SDK's copy of the spec does not list decodes to
self::Unknown rather than failing the response it arrived in (CONTRACT.md §27.11 rule 1).
Its own wire spelling is the empty string, which no server value is, so carrying an
unrecognised value back into an update is refused by the server rather than written as a
spelling it never used. A match over these cases needs an Unknown arm.
Table of Contents
Cases
- Fapi2 = 'fapi2'
- The wire value `fapi2`.
- Standard = 'standard'
- The wire value `standard`.
- Unknown = ''
- A value this SDK's copy of the spec does not list; see the type's summary.
Methods
- fromWire() : self
- Parses a wire value into a ClientProfile, mapping an unrecognised one to {@see self::Unknown}.
- toWire() : string
- The wire spelling of this case, for a request body.
Cases
Standard
The wire value `standard`.
Fapi2
The wire value `fapi2`.
Unknown
A value this SDK's copy of the spec does not list; see the type's summary.
Methods
fromWire()
Parses a wire value into a ClientProfile, mapping an unrecognised one to {@see self::Unknown}.
public
static fromWire(string $value) : self
Never throws. A parse error here would fail the whole response the value arrived in, so
one unrecognised field of one record would take down the page it was on (§27.11 rule 1).
A match over this enum needs an Unknown arm.
Parameters
- $value : string
Return values
selftoWire()
The wire spelling of this case, for a request body.
public
toWire() : string
self::Unknown has none: it stands for a value this SDK never saw, and sending it
back as the empty string would leave the refusal to the server. It raises a ValidationError here instead, before any request is made
(CONTRACT.md §34.2 P12.2(a)). Use ->value to render for a log line.