Create a resource for an API consumer to retrieve their registration information

[alpaycetin74]

What type of PR is this?

Add one of the following kinds:

• enhancement/feature

What this PR does / why we need it:

Create a new API resource for an API consumer to retrieve a list of their existing registrations.
This may be useful in case a consumer loses track of the registration ids they have received when they had created registrations with the POST request.

Which issue(s) this PR fixes:

Fixes #70

Special notes for reviewers:

Changelog input

 release-note

Additional documentation

[github-actions]

🦙 MegaLinter status: ✅ SUCCESS

Descriptor	Linter	Files	Fixed	Errors	Elapsed time
✅ ACTION	actionlint	2		0	0.01s
✅ API	spectral	2		0	3.37s
✅ GHERKIN	gherkin-lint	5		0	1.76s
✅ REPOSITORY	git_diff	yes		no	0.01s
✅ REPOSITORY	secretlint	yes		no	0.77s
✅ YAML	yamllint	2		0	0.55s

See detailed report in MegaLinter reports

MegaLinter is graciously provided by

[hdamker]

Short comment on terminology: the issue says "customer", here "client" is used, but if the API Consumer is meant, than "API Consumer" would be the right term according to https://github.com/camaraproject/Commonalities/blob/main/documentation/Glossary.md

[GillesInnov35]

thanks @alpaycetin74 , I see that Commonalities recommend for pagination https://github.com/camaraproject/Commonalities/blob/main/documentation/CAMARA-API-Design-Guide.md#41-pagination

The HTTP codes that the server will use as a response are:
200: the response includes the complete list of resources
206: the response does not include the complete list of resources
400: request outside the range of the resource list

[alpaycetin74]

thanks @alpaycetin74 , I see that Commonalities recommend for pagination https://github.com/camaraproject/Commonalities/blob/main/documentation/CAMARA-API-Design-Guide.md#41-pagination

The HTTP codes that the server will use as a response are: 200: the response includes the complete list of resources 206: the response does not include the complete list of resources 400: request outside the range of the resource list

Thanks @GillesInnov35 I'll add 206 code and a specific example for 400 error.

[alpaycetin74]

hello @GillesInnov35 , I added http 206 response code.
I also found out there is an ongoing discussion in commonalities for pagination: camaraproject/Commonalities#592

I'll keep an eye on that and adapt if commonality guidelines change. Thank you.

[GillesInnov35]

LGTM, thanks @alpaycetin74