SemVer & Package Manifest / Lockfile Diff Judge API
Diff two package.json files to flag breaking SemVer bumps and risky dependency changes.
Diff two OpenAPI 3.x or JSON Schemas to catch breaking changes and recommend SemVer bumps. Compare two OpenAPI 3.x specs or JSON Schemas to detect breaking changes, removed endpoints, tightened required fields, and recommend a SemVer bump.
{
"ok": true,
"data": {
"compatible": false,
"detected_mode": "json_schema",
"breaking_count": 2,
"non_breaking_count": 0,
"changes": [
{
"path": "$.email",
"kind": "required_field_added",
"severity": "breaking",
"message": "Field 'email' became required",
"before": false,
"after": true
},
{
"path": "$.name",
"kind": "property_removed",
"severity": "breaking",
"message": "Property 'name' was removed",
"before": "name",
"after": null
}
]
},
"meta": {
"request_id": "req_sd_01",
"ms": 1
}
}
curl -X POST "https://api.tinplate.dev/v1/schema-diff" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TINPLATE_KEY" \
-d '{"mode":"json_schema","before":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"}}},"after":{"type":"object","required":["id","email"],"properties":{"id":{"type":"string"},"email":{"type":"string"}}}}'import { TinplateClient } from "@tinplate/sdk";
const tinplate = new TinplateClient({
apiKey: process.env.TINPLATE_API_KEY!,
});
const { data, meta } = await tinplate.call("/v1/schema-diff", {
"mode": "json_schema",
"before": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"after": {
"type": "object",
"required": [
"id",
"email"
],
"properties": {
"id": {
"type": "string"
},
"email": {
"type": "string"
}
}
}
});
console.log(`[${meta.ms} ms]`, data);import requests
response = requests.post(
"https://api.tinplate.dev/v1/schema-diff",
headers={
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_TINPLATE_KEY",
},
json={
"mode": "json_schema",
"before": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"after": {
"type": "object",
"required": [
"id",
"email"
],
"properties": {
"id": {
"type": "string"
},
"email": {
"type": "string"
}
}
}
}
)
print(response.json())const response = await fetch("https://api.tinplate.dev/v1/schema-diff", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_TINPLATE_KEY",
},
body: JSON.stringify({
"mode": "json_schema",
"before": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"after": {
"type": "object",
"required": [
"id",
"email"
],
"properties": {
"id": {
"type": "string"
},
"email": {
"type": "string"
}
}
}
}),
});
const result = await response.json();
console.log(result);{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "tinplate_schema_diff",
"arguments": {
"mode": "json_schema",
"before": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"after": {
"type": "object",
"required": [
"id",
"email"
],
"properties": {
"id": {
"type": "string"
},
"email": {
"type": "string"
}
}
}
}
}
}POST /v1/schema-diff)| Parameter | Type & Constraints | Description |
|---|---|---|
before required |
object |
Previous JSON Schema or OpenAPI 3.x document. |
after required |
object |
New JSON Schema or OpenAPI 3.x document. |
mode optional |
"auto" | "json_schema" | "openapi" |
Comparison mode (auto detects OpenAPI when 'paths' and 'openapi' are present). |
data Object Fields (200 OK)| Field | Type | Description |
|---|---|---|
compatible |
boolean |
Field 'compatible' |
detected_mode |
"json_schema" | "openapi" |
Field 'detected_mode' |
breaking_count |
integer |
Field 'breaking_count' |
non_breaking_count |
integer |
Field 'non_breaking_count' |
changes |
object[] |
Field 'changes' |
Release: v1.0.39 ·
Verified: 16 November 2026 ·
Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) ·
See Full Portfolio Benchmarks →
Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev:
Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).
| Plan | Monthly Price | Included Requests | Rate Limit | Max Payload | Best For |
|---|---|---|---|---|---|
| BASIC | $0.00 / mo | 500 / month | 10 req / min | 64 KB | Evaluation & CI smoke tests |
| PRO | $9.99 / mo | 15,000 / month | 60 req / min | 128 KB | Solo devs & production apps |
| ULTRA | $29.99 / mo | 100,000 / month | 300 req / min | 256 KB | Growing SaaS & multi-agent pipelines |
| MEGA | $79.99 / mo | 500,000 / month | 1,000 req / min | 256 KB | High-volume enterprise workloads |
Yes—send your main branch OpenAPI JSON as before and the PR branch OpenAPI JSON as after, and fail CI if breaking: true.
Yes: adding a required property to a request body is breaking, while adding a new property to a response body is non-breaking (minor).
Yes, local #/components/schemas/... and #/$defs/... pointers are resolved automatically.
Stateless in-memory schema comparison; specs are never stored.
Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.
Diff two package.json files to flag breaking SemVer bumps and risky dependency changes.
Validate and auto-repair broken LLM tool-call arguments against your JSON Schema.
Repair malformed or truncated LLM JSON outputs into valid, schema-checked JSON in 1 ms.