This library offers a collection of commonly used data types in API contexts, ensuring correct marshalling, unmarshalling, and validation. By standardizing these types across all our API libraries, we aim to reduce redundancy, increase consistency, and enhance type safety.

Features

• Standardized Types: Tailored for API data interchange
• Validation: Built-in validation rules to ensure data integrity before processing or transmission.
• JSON Marshalling/Unmarshalling: Custom JSON handling for each type to handle special cases (e.g., ensuring email addresses are formatted correctly).
• Used Across go-api-libs: These types are employed by all API libraries within the go-api-libs organization for consistency.

Usage

To install the library, use the following command:

go get github.com/go-api-libs/types

When using any of the API libraries from the go-api-libs organization, you can trust that types in successful API responses are valid.

Beyond that, here's how you can use some types from this library:

package main

import (
	"fmt"

	"github.com/go-api-libs/types"
)

func main() {
	// Using Email type
	email := types.Email("user@example.com")
	if err := email.Validate(); err != nil {
		fmt.Println(err)
	} else {
		fmt.Println("Valid email address")
	}
}

Additional Information

• Go Reference: API documentation.

Contributing

Contributions are welcome — please open an issue or a pull request on GitHub.

License

This project is licensed under the Apache 2.0 License.