OpenAPI & JSON Schema Breaking-Change Diff API
Diff two OpenAPI 3.x or JSON Schemas to catch breaking changes and recommend SemVer bumps.
Diff two package.json files to flag breaking SemVer bumps and risky dependency changes. Compare two package.json manifests or dependency maps to flag major breaking upgrades, 0.x instability, prerelease tags, git/tarball URLs, and supply-chain risks.
{
"ok": true,
"data": {
"verdict": "block",
"risk_score": 64,
"breaking_count": 0,
"summary": {
"total_changes": 3,
"major_breaking": 0,
"zero_ver_breaking": 0,
"downgrades": 0,
"unpinned_or_vcs": 1,
"added": 0,
"removed": 0,
"minor_or_patch": 1
},
"changes": [
{
"package": "hono",
"section": "dependencies",
"before_spec": "^4.6.0",
"after_spec": "^4.7.1",
"change_type": "minor_upgrade",
"risk": "low",
"explanation": "Backward-compatible minor upgrade for hono: ^4.6.0 -> ^4.7.1."
},
{
"package": "left-pad",
"section": "dependencies",
"before_spec": null,
"after_spec": "github:user/repo",
"change_type": "unpinned_or_vcs",
"risk": "critical",
"explanation": "Added left-pad@github:user/repo with unpinned tag, wildcard, or VCS URL."
},
{
"package": "zod",
"section": "dependencies",
"before_spec": "^3.23.8",
"after_spec": "^4.0.0-beta.1",
"change_type": "prerelease_introduced",
"risk": "high",
"explanation": "Switched zod from stable (^3.23.8) to pre-release (^4.0.0-beta.1)."
}
],
"recommendations": [
"Pin wildcard (*, latest) and VCS dependencies to exact SemVer ranges or commit SHAs."
]
},
"meta": {
"request_id": "req_slj_01",
"ms": 1
}
}
curl -X POST "https://api.tinplate.dev/v1/semver-lockfile-judge" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TINPLATE_KEY" \
-d '{"before":{"dependencies":{"zod":"^3.23.8","hono":"^4.6.0"}},"after":{"dependencies":{"zod":"^4.0.0-beta.1","hono":"^4.7.1","left-pad":"github:user/repo"}}}'import { TinplateClient } from "@tinplate/sdk";
const tinplate = new TinplateClient({
apiKey: process.env.TINPLATE_API_KEY!,
});
const { data, meta } = await tinplate.call("/v1/semver-lockfile-judge", {
"before": {
"dependencies": {
"zod": "^3.23.8",
"hono": "^4.6.0"
}
},
"after": {
"dependencies": {
"zod": "^4.0.0-beta.1",
"hono": "^4.7.1",
"left-pad": "github:user/repo"
}
}
});
console.log(`[${meta.ms} ms]`, data);import requests
response = requests.post(
"https://api.tinplate.dev/v1/semver-lockfile-judge",
headers={
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_TINPLATE_KEY",
},
json={
"before": {
"dependencies": {
"zod": "^3.23.8",
"hono": "^4.6.0"
}
},
"after": {
"dependencies": {
"zod": "^4.0.0-beta.1",
"hono": "^4.7.1",
"left-pad": "github:user/repo"
}
}
}
)
print(response.json())const response = await fetch("https://api.tinplate.dev/v1/semver-lockfile-judge", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_TINPLATE_KEY",
},
body: JSON.stringify({
"before": {
"dependencies": {
"zod": "^3.23.8",
"hono": "^4.6.0"
}
},
"after": {
"dependencies": {
"zod": "^4.0.0-beta.1",
"hono": "^4.7.1",
"left-pad": "github:user/repo"
}
}
}),
});
const result = await response.json();
console.log(result);{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "tinplate_semver_lockfile_judge",
"arguments": {
"before": {
"dependencies": {
"zod": "^3.23.8",
"hono": "^4.6.0"
}
},
"after": {
"dependencies": {
"zod": "^4.0.0-beta.1",
"hono": "^4.7.1",
"left-pad": "github:user/repo"
}
}
}
}
}POST /v1/semver-lockfile-judge)| Parameter | Type & Constraints | Description |
|---|---|---|
before required |
string | object |
Field 'before' |
after required |
string | object |
Field 'after' |
include_dev_dependencies optional |
booleandefault: true |
Field 'include_dev_dependencies' |
fail_on_zero_ver_minor optional |
booleandefault: true |
Field 'fail_on_zero_ver_minor' |
data Object Fields (200 OK)| Field | Type | Description |
|---|---|---|
verdict |
"allow" | "review" | "block" |
Field 'verdict' |
risk_score |
integer |
Field 'risk_score' |
breaking_count |
integer |
Field 'breaking_count' |
summary |
object |
Field 'summary' |
changes |
object[] |
Field 'changes' |
recommendations |
string[] |
Field 'recommendations' |
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 |
Per SemVer 2.0.0 spec clause 4, initial development versions (0.y.z) treat minor bumps (e.g. 0.4.0 -> 0.5.0) as breaking changes.
Yes, if a diff adds or modifies preinstall, install, or postinstall scripts, it raises a supply-chain review flag.
Yes—auto-merge when verdict is 'safe' (patch/minor bumps only, no new scripts or git URLs) and require human review on 'review' or 'high_risk'.
Stateless in-memory manifest diffing; zero retention.
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 OpenAPI 3.x or JSON Schemas to catch breaking changes and recommend SemVer bumps.
Detect and mask leaked API keys, JWTs, and private keys in logs, diffs, and prompts.
Audit MCP server manifests for hidden tool poisoning, shell risks, and excessive permissions.