NOTE 1: This identifier can be retrieved from the resource referenced by the "Location" HTTP header in the response to a POST request creating a new "Individual Subject instance" resource. It can also be retrieved from the "id" attribute in the message content of that response.
required:true
style:simple
explode:false
schema:
type:string
certificateId:
name:certificateId
in:path
description:|
certificateId Identifier of the Certificate instance. See note 2.
NOTE 2: This identifier can be retrieved from the resource referenced by the "Location" HTTP header in the response to a POST request creating a new "Individual Certificate instance" resource. It can also be retrieved from the "id" attribute in the message content of that response.
required:true
style:simple
explode:false
schema:
type:string
responses:
SubjectInstance.Post.201:
description:>
201 CREATED
Shall be returned when a new "Individual Subject instance" resource and the associated Subject instance identifier has been created successfully.
The response body shall contain a representation of the created Subject instance, as defined in clause x.x.x.x.
The HTTP response shall include a "Location" HTTP header that contains the resource URI of the created Subject instance.
headers:
Location:
description:|
The resource URI of the created subject resource.
style:simple
explode:false
schema:
type:string
format:url
WWW-Authenticate:
description:>
Challenge if the corresponding HTTP request has not provided
authorization, or error details if the corresponding HTTP
request has provided an invalid authorization token.
schema:
type:string
Version:
description:>
Version of the API used in the response.
schema:
type:string
Content-Type:
description:|
The MIME type of the body of the response. Reference: IETF RFC 9110
Shall be returned when a new "Individual Certificate instance" resource and the associated Certificate instance identifier has been created successfully.
The response body shall contain a representation of the created Certificate instance, as defined in clause x.x.x.x.
The HTTP response shall include a "Location" HTTP header that contains the resource URI of the created Certificate instance.
headers:
Location:
description:|
The resource URI of the created subject resource.
style:simple
explode:false
schema:
type:string
format:url
WWW-Authenticate:
description:>
Challenge if the corresponding HTTP request has not provided
authorization, or error details if the corresponding HTTP
request has provided an invalid authorization token.
schema:
type:string
Version:
description:>
Version of the API used in the response.
schema:
type:string
Content-Type:
description:|
The MIME type of the body of the response. Reference: IETF RFC 9110
Shall be returned when the whole content of the certificate file has been read successfully.
The response body shall include a copy of the certificate file.
The "Content-Type HTTP" header shall be set according to the type of the file, i.e. to "application/text" for a certificate content according to IETF RFC 7468[a].
headers:
WWW-Authenticate:
description:>
Challenge if the corresponding HTTP request has not provided
authorization, or error details if the corresponding HTTP
request has provided an invalid authorization token.
schema:
type:string
Version:
description:>
Version of the API used in the response.
schema:
type:string
IndividualCertificateContentInstance.Get.206:
description:|
206 PARTIAL CONTENT
If the CMF supports range requests, this response shall be returned when a single consecutive byte range from the content of the certificate file has been read successfully according to the request.
The response body shall contain the requested part of the certificate file.
The "Content-Range" HTTP header shall be provided according to IETF RFC 9110 [c].
The "Content-Type" HTTP header shall be set as defined above for the "200 OK" response.
headers:
WWW-Authenticate:
description:|
Challenge if the corresponding HTTP request has not provided authorization, or error details if the
corresponding HTTP request has provided an invalid authorization token.
style:simple
explode:false
schema:
type:string
Version:
description:The used API version.
style:simple
explode:false
schema:
type:string
Content-Range:
required :true
style:simple
explode:false
schema:
type:string
content:
application/*:
schema:
type:string
format:binary
IndividualCertificateContentInstance.Get.409:
description:>
409 CONFLICT
Shall be returned upon the following error: The operation cannot be executed currently, due to a conflict with the state of the resource.
The response body shall contain a ProblemDetails structure, in which the "detail" attribute shall convey more information about the error.
headers:
WWW-Authenticate:
description:>
Challenge if the corresponding HTTP request has not provided
authorization, or error details if the corresponding HTTP
request has provided an invalid authorization token.
Shall be returned upon the following error: The byte range passed in the "Range" header did not match any available byte range in the certificate file (e.g. "access after end of file").
The response body may contain a ProblemDetails structure.
headers:
WWW-Authenticate:
description:|
Challenge if the corresponding HTTP request has not provided authorization, or error details if the
corresponding HTTP request has provided an invalid authorization token.
