s3

type Service interface {
	// @gtg http-server-method POST
	// @gtg http-server-uri-path /api/v1/multipart/{bucket}/{key}
	// @gtg http-server-response-status 201
	// @gtg http-server-response-content-type application/json
	// @gtg http-server-response-json-tag data data
	// @gtg http-server-response-json-tag errorFlag error
	// @gtg http-server-response-json-tag additionalErrors additionalErrors
	// @gtg http-server-response-json-tag errorText errorText
	CreateMultipartUpload(ctx context.Context, bucket, key string) (data v1.CreateMultipartUploadData, errorFlag bool, errorText string, additionalErrors *v1.AdditionalErrors, err error)
	// @gtg http-server-method PATCH
	// @gtg http-server-uri-path /api/v1/multipart/{bucket}/{key}
	// @gtg http-server-response-status 200
	// @gtg http-server-response-content-type application/json
	UploadPartDocument(ctx context.Context, bucket string, key string, uploadID string, partNumber int64, document []byte) (err error)
	// @gtg http-server-method PUT
	// @gtg http-server-uri-path /api/v1/multipart/{bucket}/{key}
	// @gtg http-server-response-status 200
	// @gtg http-server-response-content-type application/json
	CompleteUpload(ctx context.Context, bucket string, key string, uploadID string) (err error)
	// @gtg http-server-method POST
	// @gtg http-server-uri-path /api/v1/doc/{bucket}/{key}
	// @gtg http-server-response-status 201
	// @gtg http-server-response-content-type application/json
	UploadDocument(ctx context.Context, bucket string, key string, document []byte) (err error)
	// @gtg http-server-method GET
	// @gtg http-server-uri-path /api/v1/doc/{bucket}/{key}
	// @gtg http-server-response-status 200
	// @gtg http-server-response-content-type application/json
	// @gtg http-server-response-json-tag document document
	DownloadDocument(ctx context.Context, bucket string, key string) (document []byte, err error)
	// @gtg http-server-method POST
	// @gtg http-server-uri-path /token
	// @gtg http-server-header Authorization {authToken}
	// @gtg http-server-content-type application/x-www-form-urlencoded
	// @gtg http-server-form-urlencoded scope scope
	// @gtg http-server-form-urlencoded grantType grant_type
	// @gtg http-server-response-content-type application/json
	// @gtg http-server-response-status http.StatusOK
	// @gtg http-server-response-json-tag token token
	// @gtg http-server-response-json-tag expiresIn expiresIn
	GetToken(ctx context.Context, authToken *string, scope string, grantType string) (token string, expiresIn int, err error)
	// @gtg http-server-method GET
	// @gtg http-server-uri-path /api/v1/branches
	// @gtg http-server-header Authorization {authToken}
	// @gtg http-server-cookie x-supplier-id supplierID
	// @gtg http-server-response-status 200
	// @gtg http-server-response-content-type application/json
	// @gtg http-server-response-json-tag branches branches
	GetBranches(ctx context.Context, authToken *string, supplierID *string) (branches []int, err error)
}