fhir-developer-skill

SKILL.md

HTTP Status Codes | Code | When to Use |

| 200 OK | Successful read, update, or search | | 201 Created | Successful create (include Location header) | | 204 No Content | Successful delete | | 400 Bad Request | Malformed JSON, wrong resourceType | | 401 Unauthorized | Missing, expired, revoked, or malformed token (RFC 6750) | | 403 Forbidden | Valid token but insufficient scopes |

| 404 Not Found | Resource doesn't exist | | 412 Precondition Failed | If-Match ETag mismatch (NOT 400!) | | 422 Unprocessable Entity | Missing required fields, invalid enum values, business rule violations |

FHIR API development guide for building healthcare endpoints. Use when: (1) Creating FHIR REST endpoints (Patient, Observation, Encounter, Condition, MedicationRequest), (2) Validating FHIR resources and returning proper HTTP status codes and error responses, (3) Implementing SMART on FHIR authorization and OAuth scopes, (4) Working with Bundles, transactions, batch operations, or search pagination. Covers FHIR R4 resource structures, required fields, value sets (status codes, gender, intent), coding systems (LOINC, SNOMED, RxNorm, ICD-10), and OperationOutcome error handling. Source: anthropics/healthcare.

View raw