taxcode-converter-golang

taxcode-converter-golang is a simple golang service exposing two REST APIs dealing with italian tax code (codice fiscale).

/api/v1/taxcode:calculate-person-data

POST

Summary:

Calculate data of a person starting from his tax code.

Parameters

Name	Located in	Description	Required	Schema
CalculatePersonDataRequest	body	CalculatePersonDataRequest	Yes	CalculatePersonDataRequest

Responses

Code	Description	Schema
200	OK	CalculatePersonDataResponse
400	Bad Request	ProblemDetails
404	Not Found	ProblemDetails
500	Internal Server Error	ProblemDetails

/api/v1/taxcode:calculate-tax-code

POST

Summary:

Calculate tax code starting from the data of a person.

Parameters

Name	Located in	Description	Required	Schema
CalculateTaxCodeRequest	body	CalculateTaxCodeRequest	Yes	CalculateTaxCodeRequest

Responses

Code	Description	Schema
200	OK	CalculateTaxCodeResponse
400	Bad Request	ProblemDetails
404	Not Found	ProblemDetails
500	Internal Server Error	ProblemDetails

Models

ProblemDetails

Name	Type	Description	Required
detail	string	Detail is a human-readable explanation specific to this occurrence of the problem. If present, it ought to focus on helping the client correct the problem, rather than giving debugging information.	No
instance	string	Instance is a URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.	No
status	integer	Status is the HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.	No
title	string	Title is a short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization (e.g., using proactive content negotiation; see [RFC7231], Section 3.4).	No
type	string	Type is a URI reference [RFC3986] that identifies the problem type. This specification encourages that, when dereferenced, it provide human-readable documentation for the problem type (e.g., using HTML [W3C.REC-html5-20141028]). When this member is not present, its value is assumed to be "about:blank".	No

CalculatePersonDataRequest

Name	Type	Description	Required
taxCode	string		Yes

CalculatePersonDataResponse

Name	Type	Description	Required
birthPlace	string		No
dateOfBirth	date		No
gender	string		No
name	string		No
province	string		No
surname	string		No
taxCode	string		No

CalculateTaxCodeRequest

Name	Type	Description	Required
birthPlace	string		Yes
dateOfBirth	date		Yes
gender	string		Yes
name	string		Yes
province	string		Yes
surname	string		Yes

CalculateTaxCodeResponse

Name	Type	Description	Required
taxCode	string		No

Credits

Fiber is a Go web framework built on top of Fasthttp, the fastest HTTP engine for Go. It's designed to ease things up for fast development with zero memory allocation and performance in mind.