mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
358 lines
22 KiB
HTML
358 lines
22 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hanzo-gochimp</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/hanzo-gochimp.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-gochimp">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-gochimp.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>hanzo-gochimp</h1><p class="lede">GoChimp3 is a Go client library for the MailChimp API v3.0.</p><h1>Hanzo GoChimp3 - MailChimp API v3 Client for Go</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-commerce.md</code>, <code>hanzo/hanzo-commerce-api.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>GoChimp3 is a <strong>Go client library for the MailChimp API v3.0</strong>. It provides typed Go structs and methods for managing audiences (lists), members, campaigns, automations, e-commerce data, templates, segments, webhooks, and batch operations. Single package, zero external dependencies beyond <code>net/http</code> and <code>encoding/json</code> from the standard library. Test dependency on <code>stretchr/testify</code>.</p>
|
|
<h3>Why GoChimp3?</h3>
|
|
<ul><li><strong>Pure Go</strong>: Standard library HTTP client with configurable timeout and transport</li><li><strong>Full API v3 coverage</strong>: Lists, members, campaigns, automations, e-commerce, templates, segments, webhooks, batch operations</li><li><strong>Fluent API</strong>: Chain methods on response objects (e.g., <code>list.CreateMember(req)</code>)</li><li><strong>Typed errors</strong>: <code>APIError</code> struct with status, type, title, detail, and field-level errors</li><li><strong>Configurable</strong>: Custom timeout, HTTP transport, debug mode with request/response dumping</li></ul>
|
|
<h3>Tech Stack</h3>
|
|
<ul><li><strong>Language</strong>: Go (module requires Go 1.13+)</li><li><strong>Module</strong>: <code>github.com/hanzoai/gochimp3</code></li><li><strong>Dependencies</strong>: <code>github.com/stretchr/testify v1.5.1</code> (test only)</li><li><strong>CI</strong>: Travis CI</li><li><strong>License</strong>: MIT</li></ul>
|
|
<h3>OSS Base</h3>
|
|
<p>Repo: <code>hanzoai/gochimp3</code> (68 stars). Default branch: <code>master</code>.</p>
|
|
<h2>When to use</h2>
|
|
<ul><li>Adding/removing/updating MailChimp list subscribers from Go services</li><li>Creating and sending email campaigns programmatically</li><li>Syncing e-commerce order/product/customer data to MailChimp</li><li>Managing automation workflows</li><li>Batch subscribing members with update-or-create semantics</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>MailChimp API key</strong> (format: <code><key>-<datacenter></code>, e.g., <code>abc123-us6</code>)</li><li><strong>Go 1.13+</strong> (uses Go modules)</li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | Module | <code>github.com/hanzoai/gochimp3</code> | | Go version | 1.13+ | | API version | MailChimp API v3.0 | | Auth | HTTP Basic Auth (API key) | | Default branch | <code>master</code> | | License | MIT | | Repo | <code>github.com/hanzoai/gochimp3</code> |</p>
|
|
<h2>One-file quickstart</h2>
|
|
<pre><code class="lang-go">package main
|
|
|
|
import (
|
|
"fmt"
|
|
"os"
|
|
"time"
|
|
|
|
"github.com/hanzoai/gochimp3"
|
|
)
|
|
|
|
func main() {
|
|
client := gochimp3.New(os.Getenv("MAILCHIMP_API_KEY"))
|
|
client.Timeout = 5 * time.Second
|
|
|
|
// Get a list by ID
|
|
list, err := client.GetList("YOUR_LIST_ID", nil)
|
|
if err != nil {
|
|
fmt.Println("Error:", err)
|
|
os.Exit(1)
|
|
}
|
|
|
|
// Subscribe a member
|
|
req := &gochimp3.MemberRequest{
|
|
EmailAddress: "[email protected]",
|
|
Status: "subscribed",
|
|
MergeFields: map[string]interface{}{
|
|
"FNAME": "Jane",
|
|
"LNAME": "Doe",
|
|
},
|
|
}
|
|
|
|
member, err := list.CreateMember(req)
|
|
if err != nil {
|
|
fmt.Println("Subscribe failed:", err)
|
|
os.Exit(1)
|
|
}
|
|
fmt.Println("Subscribed:", member.EmailAddress)
|
|
}</code></pre>
|
|
<h2>Core Concepts</h2>
|
|
<h3>Architecture</h3>
|
|
<pre><code>gochimp3.New(apiKey) -> *API
|
|
|
|
|
|-- API.GetLists() -> *ListOfLists (paginated)
|
|
|-- API.GetList(id) -> *ListResponse (has sub-methods)
|
|
|-- API.GetCampaigns() -> *ListOfCampaigns
|
|
|-- API.CreateCampaign()
|
|
|-- API.SendCampaign()
|
|
|
|
|
ListResponse (fluent sub-API)
|
|
|-- list.GetMembers()
|
|
|-- list.CreateMember()
|
|
|-- list.UpdateMember()
|
|
|-- list.AddOrUpdateMember() (PUT - upsert)
|
|
|-- list.DeleteMember()
|
|
|-- list.DeleteMemberPermanent()
|
|
|-- list.BatchSubscribeMembers()
|
|
|-- list.GetInterestCategories()
|
|
|-- list.GetMergeFields()
|
|
|-- list.CreateMergeField()
|
|
|
|
|
Member (fluent sub-API)
|
|
|-- member.GetActivity()
|
|
|-- member.GetGoals()
|
|
|-- member.GetNotes() / CreateNote() / UpdateNote()
|
|
|-- member.GetTags() / UpdateTags()</code></pre>
|
|
<h3>API Client</h3>
|
|
<p>The <code>API</code> struct is the entry point. It extracts the datacenter from the API key using a regex and constructs the endpoint URL (<code>https://<dc>.api.mailchimp.com/3.0</code>). All requests use HTTP Basic Auth with the key.</p>
|
|
<pre><code class="lang-go">client := gochimp3.New("your-api-key-us6")
|
|
client.Timeout = 10 * time.Second // optional
|
|
client.Debug = true // dumps request/response
|
|
client.Transport = customTransport // optional custom transport</code></pre>
|
|
<h3>Query Parameters</h3>
|
|
<p>All list/get methods accept typed query parameter structs:</p>
|
|
<ul><li><code>BasicQueryParams</code> -- Status, SortField, SortDirection, Fields, ExcludeFields</li><li><code>ExtendedQueryParams</code> -- adds Count and Offset for pagination</li><li><code>ListQueryParams</code> -- adds date filters and email filter</li><li><code>CampaignQueryParams</code> -- adds type, status, date filters, list/folder IDs</li></ul>
|
|
<h3>Error Handling</h3>
|
|
<p>API errors are returned as <code>*APIError</code> implementing the <code>error</code> interface:</p>
|
|
<pre><code class="lang-go">member, err := list.CreateMember(req)
|
|
if err != nil {
|
|
if apiErr, ok := err.(*gochimp3.APIError); ok {
|
|
fmt.Println("Status:", apiErr.Status)
|
|
fmt.Println("Detail:", apiErr.Detail)
|
|
for _, e := range apiErr.Errors {
|
|
fmt.Println("Field:", e.Field, "Message:", e.Message)
|
|
}
|
|
}
|
|
}</code></pre>
|
|
<h3>Member ID by Email</h3>
|
|
<p>MailChimp uses MD5 hash of lowercase email as member ID. The library provides a helper:</p>
|
|
<pre><code class="lang-go">member := api.MemberForApiCalls("list-id", "[email protected]")
|
|
// member.ID is now the MD5 hash, ready for API calls</code></pre>
|
|
<h2>Directory structure</h2>
|
|
<pre><code>github.com/hanzoai/gochimp3/
|
|
api.go # API client, HTTP transport, request/response handling
|
|
api_test.go # Client tests
|
|
common_types.go # APIError, QueryParams, Link, Address, Contact, etc.
|
|
lists.go # Lists CRUD, abuse reports, activity, clients, growth history,
|
|
# interest categories, interests, batch subscribe, merge fields
|
|
members.go # Members CRUD, activity, goals, notes, tags
|
|
campaigns.go # Campaigns CRUD, send test, send, content updates
|
|
automations.go # Automation workflows, emails, queues
|
|
automation_workflows.go # Workflow-level operations
|
|
ecommerce.go # Stores, products, variants, orders, carts, customers
|
|
segments.go # List segments CRUD, batch modify
|
|
templates.go # Templates CRUD
|
|
template_folders.go # Template folder CRUD
|
|
campaign_folders.go # Campaign folder CRUD
|
|
batches.go # Batch operations
|
|
webhooks.go # Webhook CRUD on lists
|
|
search.go # Search members
|
|
events.go # Member events
|
|
events_test.go # Events tests
|
|
root.go # API root info
|
|
json.go # JSON helper (custom time parsing)
|
|
go.mod # Module definition
|
|
go.sum # Dependency checksums</code></pre>
|
|
<h2>API Coverage</h2>
|
|
<p>| Resource | Methods | |----------|---------| | Lists | GetLists, GetList, CreateList, UpdateList, DeleteList | | Members | GetMembers, GetMember, CreateMember, UpdateMember, AddOrUpdateMember, DeleteMember, DeleteMemberPermanent, BatchSubscribeMembers | | Campaigns | GetCampaigns, GetCampaign, CreateCampaign, UpdateCampaign, DeleteCampaign, SendTestEmail, SendCampaign, GetCampaignContent, UpdateCampaignContent | | Automations | GetAutomations, GetAutomation, PauseAutomation, StartAutomation | | E-commerce | Stores, Products, Variants, Orders, Carts, Customers (full CRUD) | | Segments | GetSegments, GetSegment, CreateSegment, UpdateSegment, DeleteSegment, BatchModifySegment | | Templates | GetTemplates, GetTemplate, CreateTemplate, UpdateTemplate, DeleteTemplate | | Webhooks | GetWebhooks, GetWebhook, CreateWebhook, DeleteWebhook | | Merge Fields | GetMergeFields, GetMergeField, CreateMergeField | | Interest Categories | GetInterestCategories, GetInterestCategory, CreateInterestCategory, UpdateInterestCategory, DeleteInterestCategory | | Tags | GetTags, UpdateTags (on members) | | Search | SearchMembers |</p>
|
|
<h2>Troubleshooting</h2>
|
|
<p>| Issue | Cause | Solution | |-------|-------|----------| | "No ID provided on list" | Using ListResponse without ID | Use <code>api.GetList(id)</code> or <code>api.NewListResponse(id)</code> | | Wrong datacenter | API key format incorrect | Key must be <code><key>-<dc></code> (e.g., <code>abc-us6</code>) | | 401 Unauthorized | Invalid API key | Verify key in MailChimp account settings | | Timeout errors | Default no timeout | Set <code>client.Timeout = 10 * time.Second</code> | | Rate limits (429) | Too many requests | MailChimp allows 10 concurrent connections; add backoff |</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-commerce.md</code> - E-commerce platform (uses MailChimp for email marketing)</li><li><code>hanzo/hanzo-commerce-api.md</code> - Commerce API (subscriber sync)</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: mailchimp, email, marketing, go, api-client <strong>Prerequisites</strong>: Go 1.13+, MailChimp API key</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/hanzo-gochimp.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |