URI
A string that identifies a resource, written with a scheme and usually a path, such as https://api.example.com/tasks/1; every URL is a URI.
In more detail
URI stands for Uniform Resource Identifier. In API design a URI is a public promise: clients store it, bookmark it and build on it, so it should name things with stable nouns and survive changes to the implementation.
Examples
In web logs the request URI is the path and query the client asked for, which is where injection and traversal payloads appear, often percent-encoded.Problem Details uses a URI in type to name the kind of error and in instance for the failing request.Related terms
- URL — A web address, such as https://example.com/docs, made of a scheme, a host, an optional port and a path.
- path segment — One slash-separated piece of the path in a web address, such as tasks or 1 in /tasks/1.
- resource — Anything an API gives a name to and lets clients work with, such as one task, a collection of tasks or a job.
- URL encoding — Writing special characters in a web address as % followed by two hexadecimal digits, such as %20 for a space.
- web access log — The log a web server writes with one line per request: client address, time, request line, status code, size and often user agent.
- Problem Details — A standard JSON shape for HTTP error responses, defined in RFC 9457, with members such as type, title, status, detail and instance.
Taught in
- What MCP Is — AI Engineering: LLM Apps, RAG & Agents
- Naming Resources And Collections — Modern API Architecture: REST, GraphQL & gRPC
- HATEOAS And Hypermedia — Modern API Architecture: REST, GraphQL & gRPC
- OAuth Two And OpenID Connect — Modern API Architecture: REST, GraphQL & gRPC
- Desired State And Configuration Management — Microsoft Azure DevOps Engineer Expert (AZ-400) Exam Prep
- Audit Policy: Choosing What The Cluster Remembers — Certified Kubernetes Security Specialist (CKS) Exam Prep
- Resilient Error Handling: Problem Details & Envelopes — Production Full-Stack Engineering
- The gcloud And Product-Name Sprint — Google Cloud Associate Cloud Engineer Exam Prep
- Detection as Code: Authoring & Testing Sigma Rules — Security Operations & Threat Hunting (SOC)
- The Upgrade That Broke Nginx: Packages, Repositories And Pins On Both Families — CompTIA Linux+ (XK0-006) Exam Prep
- Debian Packages: dpkg, apt And The Sources List — LPIC-1 Linux Administrator (101-500 and 102-500) Exam Prep
- Printing With CUPS: Two Switches Per Queue — LPIC-1 Linux Administrator (101-500 and 102-500) Exam Prep
References
Certification courses
- AWS AIP-C01 course and practice exam: AI engineering with LLM apps, RAG and agents
- AZ-400 course and practice exam: Microsoft Azure DevOps Engineer Expert
- CKS course and practice exam: Certified Kubernetes Security Specialist
- Google Associate Cloud Engineer course and practice exam: Google Cloud certification
- CompTIA Linux+ course and practice exam: XK0-006
- LPIC-1 course and practice exam: Linux Administrator (101-500 and 102-500)