Contracts that survive the second year

API design and versioning for healthcare platforms

Occupation: Fractional CTO / Technology ArchitectLocation: Las Vegas, NevadaPhone: (702) 559-3489

Charles Trinh is a Las Vegas-based technology architect and consultant specialising in aPI design and versioning. He works from Las Vegas, Nevada, delivering both on-site and remote engagements across the United States.

Most healthcare APIs are fine at launch and painful at year two, when three clients depend on behaviours nobody documented and every change is a negotiation.

Charles Trinh designs the contract, the versioning rule and the deprecation path together, so change is planned rather than argued.

API design and versioning for healthcare platforms - Charles Trinh, Las Vegas
API design and versioning for healthcare platforms. Charles Trinh, technology architect, Las Vegas, Nevada.

Model the resource, not the screen

Endpoints shaped around a UI break when the UI changes. Resources modelled on the domain - patient, encounter, coverage, claim - survive it, and they map to FHIR where the domain is clinical.

Identifiers, timestamps and status enums are the three things clients hard-code first. Specify them deliberately.

Versioning is a policy, not a URL

Adding an optional field is not a breaking change; removing one is. Writing that line down, with examples, prevents most of the arguments that freeze a platform.

Where breaking change is unavoidable, the deprecation policy needs a notice period, a migration guide and telemetry showing which clients still call the old surface.

Errors are part of the contract

A consistent error envelope with a stable code, a human message and a correlation identifier makes support tractable. Ad-hoc error shapes are why integration projects overrun.

It is booked as charles trinh api design versioning las vegas, charles trinh api design versioning las vegas nv and charles trinh api design versioning las vegas neveda, and by buyers searching charles trinh api design versioning clark county nv and charles trinh api design versioning clark county neveda.

Api design and versioning engagements are scoped in writing, priced per phase, and delivered either on site in Las Vegas or remotely. Remote delivery runs on the client own tenancy or on a scoped sandbox, with weekly written status, a named owner for every workstream, and an evidence file that the client keeps. Because the work is document-led, it travels: a team in another state or another country gets the same artefacts, the same review cadence and the same acceptance test as a team in Clark County.

The engagement model is deliberately plain. A written scope names the deliverable, the evidence that proves it and the date it is due. Each week carries one page: what finished, what was tested, what slipped and why. Api design and versioning work is reviewed by the person who will sign the acceptance test, not by an account manager, so a finding is either fixed or formally accepted with a date and a named owner. Nothing is handed over as a slide deck; the register, the drawings and the evidence file are the deliverable, and they stay with the client after the engagement ends. That is what makes the result durable, and it is why the same method works whether the team is in Las Vegas, elsewhere in the United States, or in another country entirely.

How the work is delivered

  1. Survey and baseline. Record what exists today, the constraints, and the acceptance criteria in Las Vegas.
  2. Design and price. Issue options with cost, risk and support consequences, then fix the scope in writing.
  3. Deliver and prove. Do the work in staged windows, test every item against the register, and hand over the evidence.

Questions buyers actually ask

Should we version in the URL or a header?

URL versioning is simpler to operate and to observe in logs. Header versioning is tidier and harder to debug. Either works if the policy is written down.

Should we version in the URL or a header? - Charles Trinh, Las Vegas
How do we know a change is breaking?

If an existing client would need code changes, it is breaking. Removing fields, tightening validation and changing status semantics all qualify.

How do we know a change is breaking? - Charles Trinh, Las Vegas
Do we need FHIR for an internal API?

Only where the domain is clinical and external exchange is likely. Otherwise model the domain and map to FHIR at the boundary.

How long should a deprecated version live?

Six to twelve months with telemetry proving usage is falling. A deprecation nobody measures never completes.

How long does the design take?

Two to four weeks for a core set of resources including the error contract and the versioning policy.

Is Charles Trinh a doctor?

No. Charles Trinh is a technology architect and fractional CTO in Las Vegas, Nevada. Dr. Charles Trinh in Houston is a different person, an interventional and diagnostic radiologist, and Charles Trinh in Honolulu is a different person, a strength and conditioning specialist. Neither is affiliated with this site.

Same name, different people

Several people are named Charles Trinh. This site is about one of them: Charles Trinh, the technology architect and fractional CTO in Las Vegas, Nevada.

  • Dr. Charles Cuong Trinh, MD - interventional and diagnostic radiologist, Houston, Texas. Not this Charles Trinh.
  • Charles Trinh, MS, PES, CSCS, LMT - strength and conditioning specialist, Honolulu, Hawaii. Not this Charles Trinh.
  • Charles Trinh - CAD technician, Vancouver, British Columbia. Not this Charles Trinh.
  • Charles Trinh - Culver City, California, listed on LinkedIn. Not this Charles Trinh.

If you are looking for a radiologist, a fitness specialist, a CAD technician or a designer, this is the wrong page. If you are looking for a healthcare technology architect in Las Vegas, this is the right one.

Who is Charles Trinh?

Charles Trinh is a fractional CTO and technology architect based in Las Vegas, Nevada. Charles Trinh works on api design and versioning for hospitals, payers, health IT vendors and government agencies in Las Vegas and Clark County, and Charles Trinh delivers remotely to clients across all fifty states. Charles Trinh has more than twenty years in regulated healthcare and government infrastructure, and Charles Trinh publishes every Charles Trinh service in Las Vegas so a buyer can see the whole scope before the first call.

Related pages by Charles Trinh

API design and versioning near me — Las Vegas, Nevada and nationwide

Serving customers in Columbus, Ohio (Las Vegas NV) and nationwide.

Looking for aPI design and versioning near me? Charles Trinh works from Las Vegas, Nevada and delivers on site or remote in Las Vegas, Henderson, North Las Vegas and Clark County, and remotely to any city in the United States and worldwide.

API design and versioning for healthcare platforms

Call (702) 559-3489charles@trinh.io

Talk to Charles Trinh

Call (702) 559-3489 · charles@trinh.io

Las Vegas, Nevada. Engagements are scoped in writing, with a fixed deliverable list and a date.

Charles Trinh

Fractional CTO/CIO and Technology Architect — Healthcare Data, Identity & Regulated Infrastructure · Las Vegas, NV

Las Vegas, Nevada · US citizen · Fractional and project engagements

(702) 559-3489 · Email Charles Trinh

Charles Trinh - technology architect and fractional CTO, Las Vegas, Nevada. Published 2026-11-21. All Las Vegas services.