API Evangelist enhancements for Centene Provider Directory

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Centene Provider Directory
  version: 1.0.0
extends: openapi/centene-fhir-provider-directory-openapi.json
x-generated: '2026-09-07'
x-method: generated
x-source: openapi/centene-fhir-provider-directory-openapi.json
x-note: Additive only. This overlay records what API Evangelist established about the contract - provenance,
  the real production host, standards conformance and cross-links to derived artifacts. It never rewrites
  or removes anything Centene published.
actions:
- target: $.info
  description: 'Record the observed provenance of this contract: where API Evangelist fetched it and what
    it is.'
  update:
    x-apievangelist-source: https://external-api.my.centene.com/partner-portal/files?url=<apiOASURL>
    x-apievangelist-catalogue: https://partners.centene.com/apis
    x-apievangelist-fetched: '2026-09-07'
    x-apievangelist-spec-version: 3.0.1
- target: $.info
  description: The production host, read from the partner-portal catalogue hostServers, which the spec
    servers[] block does not name.
  update:
    x-production-base-url: https://iopc-pd.api.centene.com/iopc/pd/fhir/providerdirectory
- target: $.servers
  description: Flag that servers[0] names a non-production or non-resolving host. Recorded, not rewritten
    - the original contract is never mutated.
  update:
    x-apievangelist-server-warning: servers[0] names a development or internal gateway. Production hosts
      are published only in the partner-portal catalogue hostServers, not in this document.
- target: $.info
  description: Cross-link the derived artifacts that carry the runtime semantics this contract omits.
  update:
    x-apievangelist-artifacts:
      authentication: authentication/centene-authentication.yml
      scopes: scopes/centene-scopes.yml
      conventions: conventions/centene-conventions.yml
      errors: errors/centene-problem-types.yml
      lifecycle: lifecycle/centene-lifecycle.yml
      rate_limits: rate-limits/centene-rate-limits.yml
      conformance: conformance/centene-conformance.yml
      data_model: data-model/centene-data-model.yml
- target: $.info
  description: Declare the FHIR release and implementation guides this contract conforms to, which the
    document itself does not state.
  update:
    x-fhir-version: 4.0.1
    x-implementation-guides:
    - US Core 6.1.0
    - CARIN BB 2.0.0
    - Da Vinci PDEX 1.0.0
    - Da Vinci PDEX Plan Net 1.2.0
    - Da Vinci US Drug Formulary 2.0.1
    - SMART App Launch 2.0.0 (standalone only)
    x-capability-statement: https://iopc-pd.api.centene.com/iopc/pd/fhir/providerdirectory/metadata
- target: $.info
  description: Record the pagination contract Centene documents in prose but does not express in the spec.
  update:
    x-pagination:
      style: fhir-bundle-link
      page_size: 200
      next: link[] entry where relation == 'next'
      caution: Centene's guide indexes link[1] positionally; FHIR does not guarantee link ordering.