DEV Community

Maximus Beato
Maximus Beato

Posted on • Originally published at apimesh.xyz

how to track api schema changes over time without juggling manual diffs

the problem

managing multiple api versions means keeping track of structural changes can get messy fast. manually comparing schemas is tedious, error-prone, and slows down development.

the solution

auto-fetch multiple schema versions and compare them easily. api-schema-delta does this by pulling schemas from your public endpoints and highlighting differences.

curl -X GET https://api-schema-delta.apimesh.xyz/check?endpoints=https://api.example.com/v1/schema,https://api.example.com/v2/schema
{
  "schemas": [
    {
      "version": "v1",
      "diffs": ["added field 'age'", "removed field 'nickname'"]
    },
    {
      "version": "v2",
      "diffs": ["new field 'dateOfBirth'", "changed 'name' to 'fullName'"]
    }
  ],
  "trend": "schema evolving as expected"
}
Enter fullscreen mode Exit fullscreen mode

how it works

it fetches schemas from provided endpoints, parses their structure, and compares them to identify differences. it supports both rest and graphql schemas, making it flexible for various api types.

try it today

get a free preview or check out pricing at https://api-schema-delta.apimesh.xyz. pricing is $0.005 per call, so you can use it to keep an eye on your api evolution without breaking the bank.

Top comments (0)