Skip to content

$ define api --plain-english

The Non-Technical Technical Dictionary — tech words, explained in plain English

One tech term a day, explained with an analogy anyone can understand. No coding required.

54 terms · one a day


Every term

54 terms · one a day · grouped by week.

01 The Basics 7 terms

Day 01 API How your AI talks to other apps. Day 02 Frontend & Backend What you see, and what does the work. Day 03 CLI Talk straight to the kitchen, no clicking. Day 04 Database A giant spreadsheet your software can talk to. Day 05 Server A computer that never closes. Day 06 Context Window How much your AI can hold in mind at once. Day 07 Hallucination When AI sounds confident and is just wrong.

02 AI Fundamentals 7 terms

Day 08 Token The unit AI reads and writes in. Day 09 Prompt Caching Pay once to read it, reuse it cheaply. Day 10 Agent An AI that takes actions, not just answers. Day 11 System Prompt The standing instructions your AI always follows. Day 12 Skill A saved SOP your AI can follow on demand. Day 13 Session One continuous conversation with your AI. Day 14 Compaction Summarizing the chat so it keeps fitting.

03 The Tools 7 terms

Day 15 Git / Version Control Save points for your code. Day 16 Commit A labeled snapshot you can return to. Day 17 Branch A safe copy to try changes on. Day 18 GitHub Where your code lives and gets shared. Day 19 Pull Request A proposed change, put up for review. Day 20 Open Source Code anyone can read, use, and improve. Day 21 Markdown Plain text that formats itself.

04 AI Infrastructure 7 terms

Day 22 MCP (Model Context Protocol) A universal port for your AI's tools. Day 23 SDK A toolkit for building on a service. Day 24 Webhook An app that pings you the moment something happens. Day 25 Endpoint One specific address on an API. Day 26 REST API The common rulebook most APIs follow. Day 27 HTTP Methods Get, create, update, delete. The verbs of the web. Day 28 Env File Where your secret keys live, out of the code.

05 Building & Running 6 terms

Day 29 CLAUDE.md The house rules your AI reads before it starts. Day 30 Slash Command A keyboard shortcut for a whole prompt. Day 31 Localhost A private website that runs only on your machine. Day 32 Deploy Push your work live for the world to use. Day 33 Headless Software that runs with no screen, nobody watching. Day 34 Cron Job An alarm clock that runs tasks on a schedule.

06 AI Power Tools 7 terms

Day 35 Harness The car built around the AI engine. Day 36 Computer Use AI that clicks and types like a person. Day 37 Agents SDK A starter kit for building your own AI worker. Day 38 Voice Agents An agent you just talk to out loud. Day 39 Embedding Meaning turned into numbers a computer can compare. Day 40 Vector Database Storage that finds things by meaning, not exact words. Day 41 OAuth / Agent Identity A valet key for your accounts, not the master key.

07 Developer Thinking 7 terms

Day 42 DRY Write it once, reuse it everywhere. Day 43 YAGNI Don't build what you don't need yet. Day 44 KISS Keep it simple. Skip the clever version. Day 45 Refactoring Tidying the code without changing what it does. Day 46 Technical Debt Shortcuts now that you pay for later. Day 47 Vibe Coding Building by describing it, letting AI write the code. Day 48 Async Work that runs without waiting in line.

08 How it actually runs 6 terms

Day 49 DNS The internet's phone book for site names. Day 50 CDN Copies of your site kept close to every visitor. Day 51 Object Storage A giant bucket for files on the internet. Day 52 Serverless Rent computing by the moment, no server to babysit. Day 53 Edge Running code close to your users, not far away. Day 54 Worker A small program that runs one job on demand.

Why this exists

I tried to learn to code three separate times before AI. Maybe got 10 or 20 GitHub contributions total. All three times I quit, setting up environments or some minutae that got me stuck.

Realized I don't care so much about coding as I do about just building ideas.

Since I made the switch my github contributions look much different. One prompt I started using a lot was this:

"Explain [term] to me in plain English. Like you're talking to a smart high schooler."

That's it. Every time I hit a word I didn't understand from a first principles standpoint (API, webhook, context window, deploy). I'd stop and ask.

Not "teach me to code." Just "what does this word actually mean for real?"

Once I had the words, I could ask better questions. Once I could ask better questions, I could build better things.

So I'm turning that into a thread. Every day, one tech term explained in plain english for any previous non-technicals like me.

This isn't for devs.

Bookmark this. Day 1 starts below.

01 / 54
API illustration
Day 1 · The Basics

API

TLDR:How your AI talks to other apps.

If you've ever used a drive-thru, you already understand APIs.

Your AI doesn't have hands. It can't log into your apps, click buttons, or fill out forms for you. But it doesn't need to. Shopify has an API. Klaviyo has an API. Slack, Stripe, Google Calendar, Notion. Almost every app you use has one. The API is how your AI actually gets things done in the real world.

So picture the drive-thru.

Your AI pulls up to the window. There's a menu bolted to the wall:

  • send this email

  • update this product

  • fetch these orders

  • post this message

It reads the menu, places an order, and the kitchen does the work. Your AI never walks inside. It never logs into your account. It just orders off what's posted at the window, and the food comes out.

That's an API. The window between your AI and somebody else's software.

The first time I wired my AI into Shopify, I expected to write some big scary script. I didn't write code to pull my orders. I handed it the key and it ordered "fetch these orders" off the window. That was the whole job.

The menu is the whole point, and it's also the safety.

The only things your AI can do are the things printed on that menu. That's it. If "delete every customer" isn't on the menu, your AI literally cannot order it. The window doesn't take requests that aren't listed. So an API isn't just a way in. It's a fence. The app decides exactly what's on offer, and everything else stays locked in the back where nobody at the window can reach it.

This is why companies are comfortable opening a window at all. They're not handing you the keys to the kitchen. They're handing you a menu they wrote, with a fence around everything they didn't.

Every window needs a key.

To pull up to the window, your AI needs to prove it's allowed there. That proof is the API key: a long, random string of characters that basically says "this order is coming from my account, charge it to me, let it through."

One rule matters more than all the rest, so I'll say it plainly:

Never paste your API key directly into your code.

Here's why that bites people. Code tends to end up on GitHub, and a lot of GitHub is public, meaning the entire internet can read it. Leave your key sitting in the code and you've taped your credit card to the drive-thru window for anyone walking by. People run bots that scan GitHub for exactly this. They find a leaked key, and within minutes they're ordering off your menu on your dime. Keys live in a separate, hidden file instead. More on where the secrets go later.

What this unlocks for you

Once you see the window, a lot of "how does AI actually do stuff" clicks into place. A few things APIs let your AI do without you lifting a finger:

  • Pull last week's orders out of Shopify and summarize them

  • Add a new subscriber to your Klaviyo list the second they sign up

  • Drop a message in a Slack channel when something breaks

  • Create a calendar event, send an email, update a price

None of that is the AI being clever with words. It's the AI placing orders at windows that were already open.

Without APIs, your AI is just a really good talker. It can write you a beautiful email and then sit there, unable to send it. With APIs, that same AI walks up to the window, orders "send this," and it's gone.

That's the whole leap. Without APIs, you've got a chatbot. With them, you've got an employee.

Day 1 · The Basics
Link copied