Add "retrieve block children" endpoint support

README.md

@@ -21,7 +21,7 @@ Go client for the [Notion API](https://developers.notion.com/reference).
 
 ### Blocks
 
-- [ ] Retrieve block children
+- [x] [Retrieve block children](client.go)
 - [ ] Append block children
 
 ### Users

block.go

@@ -17,7 +17,7 @@ type Block struct {
 	Heading2         *Heading       `json:"heading_2,omitempty"`
 	Heading3         *Heading       `json:"heading_3,omitempty"`
 	BulletedListItem *RichTextBlock `json:"bulleted_list_item,omitempty"`
-	NumberedListItem *RichText      `json:"numbered_list_item,omitempty"`
+	NumberedListItem *RichTextBlock `json:"numbered_list_item,omitempty"`
 	ToDo             *ToDo          `json:"to_do,omitempty"`
 	Toggle           *RichTextBlock `json:"toggle,omitempty"`
 	ChildPage        *ChildPage     `json:"rich_text,omitempty"`
@@ -55,3 +55,15 @@ const (
 	BlockTypeChildPage        BlockType = "child_page"
 	BlockTypeUnsupported      BlockType = "unsupported"
 )
+
+type FindBlockChildrenQuery struct {
+	StartCursor string
+	PageSize    int
+}
+
+// BlockChildrenResponse contains results (block children) and pagination data returned from a find request.
+type BlockChildrenResponse struct {
+	Results    []Block `json:"results"`
+	HasMore    bool    `json:"has_more"`
+	NextCursor *string `json:"next_cursor"`
+}

client.go

@@ -7,6 +7,8 @@ import (
 	"fmt"
 	"io"
 	"net/http"
+	"net/url"
+	"strconv"
 )
 
 const (
@@ -220,3 +222,42 @@ func (c *Client) UpdatePageProps(ctx context.Context, pageID string, params Upda
 
 	return page, nil
 }
+
+// FindBlockChildrenByID returns a list of block children for a given block ID.
+// See: https://developers.notion.com/reference/post-database-query
+func (c *Client) FindBlockChildrenByID(ctx context.Context, blockID string, query *FindBlockChildrenQuery) (result BlockChildrenResponse, err error) {
+	body := &bytes.Buffer{}
+
+	req, err := c.newRequest(ctx, http.MethodGet, fmt.Sprintf("/blocks/%v/children", blockID), body)
+	if err != nil {
+		return BlockChildrenResponse{}, fmt.Errorf("notion: invalid request: %w", err)
+	}
+
+	if query != nil {
+		q := url.Values{}
+		if query.StartCursor != "" {
+			q.Set("start_cursor", query.StartCursor)
+		}
+		if query.PageSize != 0 {
+			q.Set("page_size", strconv.Itoa(query.PageSize))
+		}
+		req.URL.RawQuery = q.Encode()
+	}
+
+	res, err := c.httpClient.Do(req)
+	if err != nil {
+		return BlockChildrenResponse{}, fmt.Errorf("notion: failed to make HTTP request: %w", err)
+	}
+	defer res.Body.Close()
+
+	if res.StatusCode != http.StatusOK {
+		return BlockChildrenResponse{}, fmt.Errorf("notion: failed to find block children: %w", parseErrorResponse(res))
+	}
+
+	err = json.NewDecoder(res.Body).Decode(&result)
+	if err != nil {
+		return BlockChildrenResponse{}, fmt.Errorf("notion: failed to parse HTTP response: %w", err)
+	}
+
+	return result, nil
+}