# 3rt4nm4n/turkish-apis architecture

> Architecture diagram of the GitHub repository 3rt4nm4n/turkish-apis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/3rt4nm4n/turkish-apis
- Repository: https://github.com/3rt4nm4n/turkish-apis

## Overview

This repository is a curated directory of Turkish and Turkey-related APIs, not a client library or hosted service. Its main user workflow is to browse the README catalog, compare listed APIs by description, authentication, and HTTPS support, then follow a provider link. The repository also points readers to example scripts for selected APIs. The available evidence documents those links and catalog fields, but contains no source excerpts showing how the examples make requests or how providers respond.

Main entry points: [`README.md`](https://github.com/3rt4nm4n/turkish-apis/blob/main/README.md) (API listings), [`examples`](https://github.com/3rt4nm4n/turkish-apis/tree/main/examples) (Example scripts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["API catalog"]
  node_api_catalog["API listings<br/>[README.md]"]
  node_catalog_metadata["Auth and HTTPS<br/>[README.md]"]
end

subgraph group_examples["API examples"]
  node_example_collection["Example scripts"]
end

subgraph group_providers["External providers"]
  node_btc_turk{{"BtcTurk API"}}
  node_barkod_oku{{"Barkod Oku API"}}
  node_genel_para{{"Genel Para API"}}
  node_nvi_kps{{"NVI KPS API"}}
  node_spk{{"SPK API"}}
  node_tuzla_belediyesi{{"Tuzla Belediyesi API"}}
end

node_reader(("API seeker"))

node_reader -->|"browses"| node_api_catalog
node_api_catalog -->|"lists"| node_catalog_metadata
node_api_catalog -->|"links to"| node_btc_turk
node_api_catalog -->|"links to"| node_barkod_oku
node_api_catalog -->|"links to"| node_genel_para
node_api_catalog -->|"links to"| node_nvi_kps
node_api_catalog -->|"links to"| node_spk
node_api_catalog -->|"links to"| node_tuzla_belediyesi
node_reader -->|"visits"| node_example_collection

click node_api_catalog "https://github.com/3rt4nm4n/turkish-apis/blob/main/README.md"
click node_catalog_metadata "https://github.com/3rt4nm4n/turkish-apis/blob/main/README.md"
click node_example_collection "https://github.com/3rt4nm4n/turkish-apis/tree/main/examples"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api_catalog,node_catalog_metadata toneBlue
class node_example_collection toneAmber
class node_btc_turk,node_barkod_oku,node_genel_para,node_nvi_kps,node_spk,node_tuzla_belediyesi,node_reader toneMint
```

## Components

### API catalog

- [API listings](https://github.com/3rt4nm4n/turkish-apis/blob/main/README.md): `README.md`
- [Auth and HTTPS](https://github.com/3rt4nm4n/turkish-apis/blob/main/README.md): `README.md`

### API examples

- [Example scripts](https://github.com/3rt4nm4n/turkish-apis/tree/main/examples): `examples`

### External providers

- **BtcTurk API**
- **Barkod Oku API**
- **Genel Para API**
- **NVI KPS API**
- **SPK API**
- **Tuzla Belediyesi API**

### Other components

- **API seeker**

## Connections

- API seeker → API listings: browses (evidence: `README.md`)
- API listings → Auth and HTTPS: lists (evidence: `README.md`)
- API listings → BtcTurk API: links to (evidence: `README.md`)
- API listings → Barkod Oku API: links to (evidence: `README.md`)
- API listings → Genel Para API: links to (evidence: `README.md`)
- API listings → NVI KPS API: links to (evidence: `README.md`)
- API listings → SPK API: links to (evidence: `README.md`)
- API listings → Tuzla Belediyesi API: links to (evidence: `README.md`)
- API seeker → Example scripts: visits (evidence: `README.md`)
