Add CreateEmail

Author: lcd1232

client.go

@@ -1,6 +1,7 @@
 package temp_mail_go
 
 import (
+	"bytes"
 	"context"
 	"encoding/json"
 	"io"
@@ -43,7 +44,15 @@ func NewClient(apiKey string, client *http.Client) *Client {
 }
 
 // newRequest creates a new HTTP request.
-func (c *Client) newRequest(ctx context.Context, method, path string, body io.Reader) (*http.Request, error) {
+func (c *Client) newRequest(ctx context.Context, method, path string, data interface{}) (*http.Request, error) {
+	var body io.Reader
+	if data != nil {
+		b, err := json.Marshal(data)
+		if err != nil {
+			return nil, err
+		}
+		body = bytes.NewReader(b)
+	}
 	req, err := http.NewRequestWithContext(ctx, method, baseURL+path, body)
 	if err != nil {
 		return nil, err

create_email.go

@@ -0,0 +1,78 @@
+package temp_mail_go
+
+import (
+	"context"
+	"time"
+)
+
+const (
+	// DomainTypePublic is a public domain.
+	DomainTypePublic = "public"
+	// DomainTypeCustom is user-provided domain.
+	DomainTypeCustom = "custom"
+	// DomainTypePremium is a premium domain.
+	DomainTypePremium = "premium"
+)
+
+// CreateEmailOptions represents the options to create an email.
+type CreateEmailOptions struct {
+	// Email is the email address to create. If not provided, a random email address will be generated
+	Email string
+	// DomainType is the type of domain to use for the email address.
+	// Possible values are: "public", "custom", "premium"
+	DomainType string
+	// Domain is the domain to use for the email address.
+	Domain string
+}
+
+// createEmailRequest represents the request to create an email
+type createEmailRequest struct {
+	// Email is the email address to create. If not provided, a random email address will be generated
+	Email string `json:"email"`
+	// DomainType is the type of domain to use for the email address.
+	// Possible values are: "public", "custom", "premium"
+	DomainType string `json:"domain_type"`
+	// Domain is the domain to use for the email address.
+	Domain string `json:"domain"`
+}
+
+// createEmailResponse represents the response to create an email.
+type createEmailResponse struct {
+	// Email is the email address that was created.
+	Email string `json:"email"`
+	// TTL is the time to live of the email address in seconds.
+	TTL int `json:"ttl"`
+}
+
+type CreateEmailResponse struct {
+	// Email is the email address that was created.
+	Email string
+	// TTL is the time to live of the email address in seconds.
+	TTL time.Duration
+}
+
+// CreateEmail creates an email address.
+// It returns the email address and the time to live of the email address.
+// You should use this method before getting messages for the email address.
+func (c *Client) CreateEmail(ctx context.Context, options CreateEmailOptions) (CreateEmailResponse, *Response, error) {
+	req := createEmailRequest{
+		Email:      options.Email,
+		DomainType: options.DomainType,
+		Domain:     options.Domain,
+	}
+	request, err := c.newRequest(ctx, "POST", "/v1/emails", req)
+	if err != nil {
+		return CreateEmailResponse{}, nil, err
+	}
+
+	var resp createEmailResponse
+	response, err := c.do(request, &resp)
+	if err != nil {
+		return CreateEmailResponse{}, nil, err
+	}
+
+	return CreateEmailResponse{
+		Email: resp.Email,
+		TTL:   time.Duration(resp.TTL) * time.Second,
+	}, response, nil
+}