FundamentalsBeginner
What is a JSON API? Data Payloads, Headers, and Serialization
Direct Answer & Overview
A JSON API is a web service that uses JSON (JavaScript Object Notation) as its primary data interchange format, sending and receiving structured key-value objects over HTTP.
1.Why JSON Replaced XML as the Web Standard
In the early 2000s, web APIs relied on SOAP and XML. XML was verbose, heavily nested, and computationally expensive to parse. JSON matches native JavaScript object syntax, supports fundamental data types (strings, numbers, booleans, arrays, null, nested objects), and parses natively in virtually every modern programming language in microseconds.
2.The `Content-Type: application/json` Header
For a server to parse a request body as JSON, the client must include the header `Content-Type: application/json`. Similarly, servers return `Content-Type: application/json` so clients know to deserialize the binary stream into native dictionaries or objects.
3.Serialization and Deserialization in Production
Converting an in-memory programming object into a string for transport is called serialization (`JSON.stringify()` in JS, `json.dumps()` in Python). Converting received JSON text back into a usable object is deserialization (`JSON.parse()` in JS, `json.loads()` in Python).
JSON Serialization and Deserialization Examplejavascript
// 1. In-memory data object
const requestPayload = {
model: "gpt-6-astra",
messages: [
{ role: "system", content: "You are an assistant." },
{ role: "user", content: "Extract data." }
],
temperature: 0.2
};
// 2. Serialize to JSON string for network transmission
const serializedString = JSON.stringify(requestPayload);
console.log("Serialized payload:", serializedString);
// 3. Deserialize received response string back to object
const rawApiResponse = '{"id":"chatcmpl-123","choices":[{"message":{"content":"Hello"}}]}';
const parsedObject = JSON.parse(rawApiResponse);
console.log("Extracted Content:", parsedObject.choices[0].message.content);Frequently Asked Questions
Can JSON store functions or binary data?
No. JSON only supports primitive text, numbers, booleans, arrays, and objects. Binary files (like images) must be base64-encoded to travel inside JSON.
What is the difference between JSON and JSON API specification?
JSON is the data format. JSON:API (jsonapi.org) is a formal specification for structuring document links, pagination, and relationships inside JSON.
What happens if JSON contains a trailing comma?
Standard JSON parsers will throw a SyntaxError on trailing commas. Always use valid JSON formatters.
A100
API100 Engineering Team
Infrastructure & Latency Research