API and data

Words

All learned. See them in History.

• API versioning

  Giving each shape of an API a version, in the URL like /v2/ or in a header, so old apps keep working when the API changes.

• Audit log

  A list of who did what and when, written as it happens and never edited, like "Ana changed the plan to Pro on 3 Sep at 14:02".

• Batch endpoint

  One endpoint that takes many operations in a single request, like "create these 200 contacts", and answers with a result for each one.

• Idempotent request

  A request you can send twice, or ten times, with the same result as sending it once.

• N+1 query

  Code loads a list with one query, then runs one more query for each item in it.

• Soft delete

  Deleting marks a row as deleted, for example by setting a deleted_at date, instead of removing it.

• Upsert

  One database write that inserts a row if it isn't there yet, or updates it if it is, matched by a unique key.

• Webhook

  Another service calls a URL on your server when something happens there, like "payment succeeded".