# Microsoft Fabric API for GraphQL Documentation

> **Note:** This documentation is mandatory for all production GraphQL APIs.
> Irrelevant chapters may remain empty but must not be removed. Automatically
> filled fields come from the Microsoft Fabric service; fields marked
> _"To be completed"_ must be completed manually.

---

## 1. Metadata

| Field | Value |
|-----|------|
| GraphQL API name | {{GQ_Name}} |
| Description | {{GQ_Beschreibung}} |
| GraphQL API ID | {{GQ_ID}} |
| Web URL | {{GQ_WebUrl}} |
| Number of data sources | {{GQ_AnzahlDatenquellen}} |
| Created / configured by | {{GQ_ConfiguredBy}} |
| Last modified | {{GQ_ModifiedTime}} |
| Business unit | {{GQ_Fachbereich}} |
| Corporate domain | {{GQ_Konzerndomaene}} |
| Current version | 1.0 |
| Status | Production |
| Last updated | {{GQ_ExportDatum}} |

---

## 2. Contacts & Responsibilities

| Role | Name / Team | Contact |
|-----|-------------|--------|
| Business owner | {{KONTAKT_BusinessOwner}} | {{KONTAKT_BusinessOwnerMail}} |
| Technical owner | {{KONTAKT_TechOwner}} | {{KONTAKT_TechOwnerMail}} |
| Data steward | {{KONTAKT_DataSteward}} | {{KONTAKT_DataStewardMail}} |
| Operations / Support | {{KONTAKT_Betrieb}} | {{KONTAKT_BetriebMail}} |

---

## 3. Business Goal & Context

### 3.1 Objective
{{GQ_Zielsetzung}}

### 3.2 Business Use Case
{{GQ_Anwendungsfall}}

### 3.3 Downstream Consumers (applications / services)
{{GQ_Konsumenten}}

---

## 4. Structure

### 4.1 Connected Data Sources

{{GQ_DatenquellenTabelle}}

### 4.2 GraphQL Schema

{{GQ_SchemaBlock}}

---

## 5. Data Sources & Loading

### 5.1 Data Source Details

{{GQ_DatenquellenTabelle2}}

### 5.2 Detailed Description per Data Source
{{GQ_DatenquellenDetail}}

---

## 6. Content & Usage

{{GQ_ServiceHinweis}}

### 6.1 API Usage
{{GQ_VerwendungHinweis}}

### 6.2 Parameters & Configuration
{{GQ_ParameterHinweis}}

### 6.3 Data Quality

- Error handling: {{GQ_NullHandling}}
- Data validation rules: {{GQ_Validierungsregeln}}
- Retention / historization: {{GQ_Aufbewahrung}}

### 6.4 Performance Notes

- Query complexity / optimization: {{GQ_Optimierung}}
- Known performance bottlenecks: {{GQ_PerformanceHinweise}}
- Further measures: {{GQ_Optimierungen}}

---

## 7. Operations & Maintenance

### 7.1 Operations & Orchestration

{{GQ_Beladung}}

### 7.2 Monitoring & Error Handling
{{GQ_Monitoring}}

### 7.3 Known Issues / Technical Debt
{{GQ_BekannteProbleme}}

---

## 8. Security & Permissions

### 8.1 Access & Sharing
{{GQ_Zugriffe}}

### 8.2 Sensitivity Labels
{{GQ_Labels}}

### 8.3 Risks & Limitations
{{GQ_Risiken}}

---

## 9. Versioning & Change History

### 9.1 Repository / Storage
{{GQ_Repository}}

### 9.2 Change Log

| Version | Date | Change | Type (business/technical) | Author |
|-------|-------|---------|--------------------------|-------|
| 1.0 | {{GQ_ExportDatum}} | Automatic initial documentation | technical | Auto documentation |

---

## 10. Approval & Review

| Role | Name | Date | Comment |
|-----|------|-------|----------|
| Business | {{REVIEW_FachName}} | {{REVIEW_FachDatum}} | {{REVIEW_FachKommentar}} |
| Technical | {{REVIEW_TechName}} | {{REVIEW_TechDatum}} | {{REVIEW_TechKommentar}} |

---

## 11. Appendices & References
- Parent workspace documentation
- Architecture diagrams
- Regulatory evidence (separate)
