# huandu/facebook architecture

> Architecture diagram of the GitHub repository huandu/facebook, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/huandu/facebook
- Repository: https://github.com/huandu/facebook

## Overview

This is a Go SDK for Facebook’s Graph API. The principal workflow is to create request parameters, issue a call through the default API facade or an App-backed Session, communicate with Facebook, and decode the response as a Result. The SDK also supports App authentication flows, batch requests and file uploads, and paging through results. The excerpts show the main API, session, parameter, and result responsibilities; some implementation details are unsampled, so those connections are omitted where evidence is unavailable.

Main entry points: [`session.go`](https://github.com/huandu/facebook/blob/master/session.go) (Session client), [`result.go`](https://github.com/huandu/facebook/blob/master/result.go) (Graph result), [`params.go`](https://github.com/huandu/facebook/blob/master/params.go) (Request parameters), [`paging_result.go`](https://github.com/huandu/facebook/blob/master/paging_result.go) (Page navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client setup"]
  node_facade["Default API<br/>[api.go]"]
  node_app["App credentials<br/>[app.go]"]
end

subgraph group_requests["Request handling"]
  node_session["Session client<br/>[session.go]"]
  node_params["Request parameters<br/>[params.go]"]
  node_conversion["Field conversion<br/>[conversion.go]"]
  node_binary["Upload data<br/>[filedata.go]"]
  node_transport["HTTP service<br/>[session.go]"]
end

subgraph group_responses["Response handling"]
  node_result["Graph result<br/>[result.go]"]
  node_errors["API errors<br/>[error.go]"]
end

subgraph group_features["API features"]
  node_paging["Page navigation<br/>[paging_result.go]"]
  node_batch["Batch requests<br/>[session.go]"]
  node_batchresult["Batch response<br/>[batch_result.go]"]
end

node_caller(("Go application"))
node_facebook{{"Facebook Graph API"}}

node_caller -->|"calls"| node_facade
node_caller -.->|"configures"| node_app
node_app -->|"creates"| node_session
node_facade -->|"delegates to"| node_session
node_caller -.->|"calls"| node_session
node_session -->|"prepares"| node_params
node_params -->|"converts names"| node_conversion
node_params -->|"encodes uploads"| node_binary
node_session -->|"sends requests"| node_transport
node_transport -->|"HTTP requests"| node_facebook
node_session -->|"parses response"| node_result
node_caller -->|"decodes fields"| node_result
node_caller -->|"walks pages"| node_paging
node_paging -->|"requests next page"| node_session
node_paging -->|"decodes page"| node_result
node_caller -->|"submits batch"| node_batch
node_result -->|"parses batch body"| node_batchresult

click node_facade "https://github.com/huandu/facebook/blob/master/api.go"
click node_app "https://github.com/huandu/facebook/blob/master/app.go"
click node_session "https://github.com/huandu/facebook/blob/master/session.go"
click node_params "https://github.com/huandu/facebook/blob/master/params.go"
click node_conversion "https://github.com/huandu/facebook/blob/master/conversion.go"
click node_binary "https://github.com/huandu/facebook/blob/master/filedata.go"
click node_transport "https://github.com/huandu/facebook/blob/master/session.go"
click node_result "https://github.com/huandu/facebook/blob/master/result.go"
click node_errors "https://github.com/huandu/facebook/blob/master/error.go"
click node_paging "https://github.com/huandu/facebook/blob/master/paging_result.go"
click node_batch "https://github.com/huandu/facebook/blob/master/session.go"
click node_batchresult "https://github.com/huandu/facebook/blob/master/batch_result.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_facade,node_app toneBlue
class node_session,node_params,node_conversion,node_binary,node_transport toneAmber
class node_result,node_errors,node_facebook toneMint
class node_paging,node_batch,node_batchresult toneRose
class node_caller toneIndigo
```

## Components

### Client setup

- [Default API](https://github.com/huandu/facebook/blob/master/api.go): `api.go`
- [App credentials](https://github.com/huandu/facebook/blob/master/app.go): `app.go`

### Request handling

- [Session client](https://github.com/huandu/facebook/blob/master/session.go): `session.go`
- [Request parameters](https://github.com/huandu/facebook/blob/master/params.go): `params.go`
- [Field conversion](https://github.com/huandu/facebook/blob/master/conversion.go): `conversion.go`
- [Upload data](https://github.com/huandu/facebook/blob/master/filedata.go): `filedata.go`
- [HTTP service](https://github.com/huandu/facebook/blob/master/session.go): `session.go`

### Response handling

- [Graph result](https://github.com/huandu/facebook/blob/master/result.go): `result.go`
- [API errors](https://github.com/huandu/facebook/blob/master/error.go): `error.go`

### API features

- [Page navigation](https://github.com/huandu/facebook/blob/master/paging_result.go): `paging_result.go`
- [Batch requests](https://github.com/huandu/facebook/blob/master/session.go): `session.go`
- [Batch response](https://github.com/huandu/facebook/blob/master/batch_result.go): `batch_result.go`

### Other components

- **Go application**
- **Facebook Graph API**

## Connections

- Go application → Default API: calls (evidence: `api.go`)
- Go application → App credentials: configures (evidence: `README.md`)
- App credentials → Session client: creates (evidence: `app.go`)
- Default API → Session client: delegates to (evidence: `api.go`)
- Go application → Session client: calls (evidence: `README.md`)
- Session client → Request parameters: prepares (evidence: `session.go`)
- Request parameters → Field conversion: converts names (evidence: `params.go`)
- Request parameters → Upload data: encodes uploads (evidence: `params.go`)
- Session client → HTTP service: sends requests (evidence: `session.go`)
- HTTP service → Facebook Graph API: HTTP requests (evidence: `README.md`)
- Session client → Graph result: parses response (evidence: `session.go`)
- Go application → Graph result: decodes fields (evidence: `README.md`)
- Go application → Page navigation: walks pages (evidence: `README.md`)
- Page navigation → Session client: requests next page (evidence: `paging_result.go`)
- Page navigation → Graph result: decodes page (evidence: `paging_result.go`)
- Go application → Batch requests: submits batch
- Graph result → Batch response: parses batch body (evidence: `batch_result.go`)
