DEV Community

Cover image for Form Data vs. API Payload: What's the Deal?
Athreya aka Maneshwar
Athreya aka Maneshwar

Posted on • Edited on

Form Data vs. API Payload: What's the Deal?

Hello, I'm Maneshwar. I'm building git-lrc, an AI code reviewer that runs on every commit. It is free, unlimited, and source-available on Github. Star Us to help devs discover the project. Do give it a try and share your feedback for improving the product.

Hello, I'm Maneshwar. I'm working on FreeDevTools online currently building **one place for all dev tools, cheat codes, and TLDRs* — a free, open-source hub where developers can quickly find and use tools without any hassle of searching all over the internet.

Form Data vs. API Payload: What's the Deal?

When you're sending data in a web app, you often encounter two common ways to structure that information: form data and API payloads.

While they seem to do the same job—transmitting data—how they work under the hood makes a world of difference. Let’s break it down!

What’s Form Data?

Think of form data as the old-school way of
submitting information, like filling out a form on a website.

It’s been around since the dawn of the web, and it still thrives in browsers today. Form data has two main flavors:

1. application/x-www-form-urlencoded

  • This is the default encoding for HTML forms.
  • It looks like a query string but goes in the request body. Example:
  key1=value1&key2=value2
Enter fullscreen mode Exit fullscreen mode
  • It’s lightweight and straightforward but doesn’t handle files.

2. multipart/form-data

  • If you need to upload files, this is your bestie.
  • The body is split into multiple parts, each with its own headers. Example (simplified):
  Content-Disposition: form-data; name="key1"
  value1

  Content-Disposition: form-data; name="file"; filename="example.jpg"
  [binary file data]
Enter fullscreen mode Exit fullscreen mode
  • It's bulkier but flexible for handling media.

What’s an API Payload?

Now enter API payloads, the newer, more versatile sibling.

These are great for modern APIs and are all about sending structured data.

Raw JSON Payloads

  • Clean, lightweight, and human-readable (if you’re into code).
  • Perfect for REST APIs and GraphQL. Example:
  {
    "key1": "value1",
    "key2": "value2"
  }
Enter fullscreen mode Exit fullscreen mode
  • Sent with the header:
  Content-Type: application/json
Enter fullscreen mode Exit fullscreen mode

Raw Text or Binary

  • If JSON isn’t your thing, you can send plain text or even binary data. Example:
  Content-Type: text/plain
  Body: Just a plain string here!
Enter fullscreen mode Exit fullscreen mode

Form Data vs. API Payloads: Key Differences

Feature Form Data API Payload
Encoding URL-encoded or multipart JSON, XML, or raw
Flexibility Great for forms and files Great for APIs and nesting
Browser Native Yes No, needs manual setup
Ease of Use Super simple for forms Better for developers
Example Use Case File uploads Complex API requests

A Practical Look: Using JavaScript

Form Data

const formData = new FormData();
formData.append("key1", "value1");
formData.append("file", fileInput.files[0]);

fetch("/submit", {
  method: "POST",
  body: formData,
});
Enter fullscreen mode Exit fullscreen mode

API Payload

const jsonData = {
  key1: "value1",
  key2: "value2",
};

fetch("/submit", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(jsonData),
});
Enter fullscreen mode Exit fullscreen mode

When to Use What?

  • Use form data if:

    • You're working with a browser-native form.
    • You need to upload files.
  • Use API payloads if:

    • You’re sending structured data to an API.
    • You want cleaner, more predictable payloads.

Wrap-Up: The Right Tool for the Job

Form data and API payloads both have their strengths.

The choice ultimately depends on your use case.

If you’re building a modern API-driven app, API payloads are usually the way to go.

But for simpler, form-based interactions, form data still shines.

So, next time you’re deciding how to send data, ask yourself: “Is this a web form or a power move?”

I’m building with Vite and absolutely loving it.

Working on the UI has been a dream, no useless headaches or unwanted drama, just smooth UX all the way.

Your API documentation will be ready in no time.

I’ve been building

A collection of UI/UX-focused tools crafted to simplify workflows, save time, and reduce friction in searching tools/materials.

Any feedback or contributors are welcome!

It’s online, open-source, and ready for anyone to use.

👉 Check it out:
⭐ Star it on GitHub:

Let’s make it even better together.

git-lrc
*AI agents write code fast. They also silently remove logic, change behavior, and introduce bugs -- without telling you. You often find out in production.

git-lrc fixes this. It hooks into git commit and reviews every diff before it lands. 60-second setup. Completely free.*

Any feedback or contributors are welcome! It's online, source-available, and ready for anyone to use.

⭐ Star it on GitHub:

GitHub logo HexmosTech / git-lrc

Free, Unlimited AI Code Reviews That Run on Commit

git-lrc logo

git-lrc

Free, Unlimited AI Code Reviews That Run on Commit



git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt



AI agents write code fast. They also silently remove logic, change behavior, and introduce bugs -- without telling you. You often find out in production.

git-lrc fixes this. It hooks into git commit and reviews every diff before it lands. 60-second setup. Completely free.

See It In Action

See git-lrc catch serious security issues such as leaked credentials, expensive cloud operations, and sensitive material in log statements

git-lrc-intro-60s.mp4

Why

  • 🤖 AI agents silently break things. Code removed. Logic changed. Edge cases gone. You won't notice until production.
  • 🔍 Catch it before it ships. AI-powered inline comments show you exactly what changed and what looks wrong.
  • 🔁 Build a habit, ship better code. Regular review → fewer bugs → more robust code → better results in your team.
  • 🔗 Why git? Git is universal. Every editor, every IDE, every AI…

Top comments (2)

Collapse
 
anisharaz profile image
ANISH ARAZ

really useful and clear to understand.

Collapse
 
lovestaco profile image
Athreya aka Maneshwar

Thanks @anisharaz