API (Stripe, OpenAI, Notion & 100+ more)

# API REST API reference documentation. 147 services with authentication, endpoints, and gotchas. ## Setup On first use, read `setup.md` for usage guidelines. ## When to Use User asks about integrating a third-party API. This skill provides: - Authentication documentation - Endpoint reference with curl examples - Rate limits and pagination patterns - Common mistakes to avoid ## Architecture ``` apis/ # API reference files by category ├── ai-ml.md # OpenAI, Anthropic, Cohere, etc. ├── payments.md # Stripe, PayPal, Square, etc. ├── communication.md # Twilio, SendGrid, Slack, etc. └── ... ~/api/ # User preferences (optional) └── preferences.md # Preferred language for examples ``` ## Quick Reference | File | Purpose | |------|---------| | `setup.md` | Usage guidelines | | `credentials.md` | Multi-account credential naming (`{SERVICE}_{ACCOUNT}_{TYPE}`) | | `auth.md` | Authentication patterns | | `pagination.md` | Pagination patterns | | `resilience.md` | Error handling patterns | | `webhooks.md` | Webhook patterns | ## API Categories | Category | File | Services | |----------|------|----------| | AI/ML | `apis/ai-ml.md` | anthropic, openai, cohere, groq, mistral, perplexity, huggingface, replicate, stability, elevenlabs, deepgram, assemblyai, together, anyscale | | Payments | `apis/payments.md` | stripe, paypal, square, plaid, chargebee, paddle, lemonsqueezy, recurly, wise, coinbase, binance, alpaca, polygon | | Communication | `apis/communication.md` | twilio, sendgrid, mailgun, postmark, resend, mailchimp, slack, discord, telegram, zoom | | Realtime | `apis/realtime.md` | sendbird, stream-chat, pusher, ably, onesignal, courier, knock, novu | | CRM | `apis/crm.md` | salesforce, hubspot, pipedrive, attio, close, apollo, outreach, gong | | Marketing | `apis/marketing.md` | drift, crisp, front, customer-io, braze, iterable, klaviyo | | Developer | `apis/developer.md` | github, gitlab, bitbucket, vercel, netlify, railway, render, fly, digitalocean, heroku, cloudflare, circleci, pagerduty, launchdarkly, split, statsig | | Database | `apis/database.md` | supabase, firebase, planetscale, neon, upstash, mongodb, fauna, xata, convex, appwrite | | Auth | `apis/auth-providers.md` | clerk, auth0, workos, stytch | | Media | `apis/media.md` | cloudinary, mux, bunny, imgix, uploadthing, uploadcare, transloadit, vimeo, youtube, spotify, unsplash, pexels, giphy, tenor | | Social | `apis/social.md` | twitter, linkedin, instagram, tiktok, pinterest, reddit, twitch | | Productivity | `apis/productivity.md` | notion, airtable, google-sheets, google-drive, google-calendar, dropbox, linear, jira, asana, trello, monday, clickup, figma, calendly, cal, loom, typeform | | Business | `apis/business.md` | shopify, docusign, hellosign, bitly, dub | | Geo | `apis/geo.md` | openweather, mapbox, google-maps | | Support | `apis/support.md` | intercom, zendesk, freshdesk, helpscout | | Analytics | `apis/analytics.md` | mixpanel, amplitude, posthog, segment, sentry, datadog, algolia | ## How to Navigate API Files Each category file contains multiple APIs. Use the index at the top of each file: 1. **Read the index first** — Each file starts with an index table showing API names and line numbers 2. **Jump to specific API** — Use the line number to read only that section (50-100 lines each) 3. **Example:** ```bash # Read index head -20 apis/ai-ml.md # Read specific API section sed -n '119,230p' apis/ai-ml.md ``` ## Core Rules 1. **Find the right file first** — Use the API Categories table to locate the service. 2. **Read the index, then jump** — Each file has an index. Read only the section you need. 3. **Include Content-Type** — POST/PUT/PATCH requests need `Content-Type: application/json`. 4. **Handle rate limits** — Check `X-RateLimit-Remaining` header. Implement backoff on 429. 5. **Validate responses** — Some APIs return 200 with error in body. Check response structure. 6. **Use idempotency keys** — For payments and critical operations. ## Common Mistakes - Missing `Content-Type: application/json` on POST requests - API keys in URL query params (use headers instead) - Ignoring pagination (most APIs default to 10-25 items) - No retry logic for 429/5xx errors - Assuming HTTP 200 means success ## Scope This skill is **documentation only**. It provides: - API endpoint reference - Authentication patterns - Code examples for reference The user manages their own API keys and runs commands themselves. ## External Endpoints This skill documents external APIs. Example endpoints shown are for the respective service providers (Stripe, OpenAI, etc.). ## Related Skills Install with `clawhub install <slug>` if user confirms: - `http` — HTTP request patterns - `webhook` — Webhook handling - `json` — JSON processing ## Feedback - If useful: `clawhub star api` - Stay updated: `clawhub sync`