{
  "info": {
    "name": "Greek Vocative API",
    "description": "Greek Vocative API — μετατροπή ονομάτων σε κλητική.\n\n**Variables:**\n- `api_url` — προσυμπληρωμένο: `https://posmelene.dicha.me`\n- `api_key` — το Bearer API key σου (από dashboard)",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "version": "3.0.0"
  },
  "variable": [
    { "key": "api_url", "value": "https://posmelene.dicha.me", "type": "string" },
    { "key": "api_key", "value": "",                             "type": "string" }
  ],
  "item": [
    {
      "name": "Vocative — Single Name",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Authorization", "value": "Bearer {{api_key}}" },
          { "key": "Content-Type",  "value": "application/json" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"first_name\": \"Γιώργης Παπαδόπουλος\"\n}",
          "options": { "raw": { "language": "json" } }
        },
        "url": {
          "raw": "{{api_url}}/onoma",
          "host": ["{{api_url}}"],
          "path": ["onoma"]
        },
        "description": "Μετατρέπει ένα όνομα στην κλητική.\n\nΒάλε στο `first_name` μόνο το όνομα ή ολόκληρο το πλήρες όνομα (όνομα + επώνυμο) — δέχεται Ελληνικά ή Greeklish.\n\n**Response fields:**\n- `vocative` — κεφαλαίο πρώτο γράμμα (π.χ. Γιώργη) → για email\n- `vocative_upper` — all caps χωρίς τόνους (π.χ. ΓΙΩΡΓΗ) → για SMS\n- `full_name` — ονομαστική + επώνυμο έτοιμα (π.χ. Γιώργης Παπαδόπουλος)\n- `last_name` — επώνυμο όπως δόθηκε (υπάρχει μόνο αν στάλθηκε πλήρες όνομα)\n- `confidence` — `curated`/`rule_high` = αξιόπιστο, `pending_approval` = AI πρόταση"
      },
      "response": [
        {
          "name": "200 OK",
          "status": "OK",
          "code": 200,
          "body": "{\n  \"input\": \"Γιώργης\",\n  \"nominative\": \"Γιώργης\",\n  \"vocative\": \"Γιώργη\",\n  \"vocative_lower\": \"γιώργη\",\n  \"vocative_upper\": \"ΓΙΩΡΓΗ\",\n  \"confidence\": \"curated\",\n  \"source\": \"lookup\",\n  \"gender\": \"M\",\n  \"full_name\": \"Γιώργης Παπαδόπουλος\",\n  \"last_name\": \"Παπαδόπουλος\"\n}"
        }
      ]
    },
    {
      "name": "Vocative — Batch",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Authorization", "value": "Bearer {{api_key}}" },
          { "key": "Content-Type",  "value": "application/json" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"names\": [\"Γιώργης\", \"Μαρία\", \"Νίκος\", \"Ελένη\"]\n}",
          "options": { "raw": { "language": "json" } }
        },
        "url": {
          "raw": "{{api_url}}/onoma/batch",
          "host": ["{{api_url}}"],
          "path": ["onoma", "batch"]
        },
        "description": "Batch μετατροπή — έως 500 ονόματα σε ένα request.\n\nΕπιστρέφει array `results` με ένα αντικείμενο ανά όνομα, συν `total` και `ai_calls`."
      },
      "response": [
        {
          "name": "200 OK",
          "status": "OK",
          "code": 200,
          "body": "{\n  \"results\": [\n    { \"input\": \"Γιώργης\", \"vocative\": \"Γιώργη\",  \"vocative_lower\": \"γιώργη\",  \"vocative_upper\": \"ΓΙΩΡΓΗ\",  \"confidence\": \"curated\", \"source\": \"lookup\", \"gender\": \"M\" },\n    { \"input\": \"Μαρία\",   \"vocative\": \"Μαρία\",   \"vocative_lower\": \"μαρία\",   \"vocative_upper\": \"ΜΑΡΙΑ\",   \"confidence\": \"curated\", \"source\": \"lookup\", \"gender\": \"F\" },\n    { \"input\": \"Νίκος\",   \"vocative\": \"Νίκο\",    \"vocative_lower\": \"νίκο\",    \"vocative_upper\": \"ΝΙΚΟ\",    \"confidence\": \"curated\", \"source\": \"lookup\", \"gender\": \"M\" },\n    { \"input\": \"Ελένη\",   \"vocative\": \"Ελένη\",   \"vocative_lower\": \"ελένη\",   \"vocative_upper\": \"ΕΛΕΝΗ\",   \"confidence\": \"curated\", \"source\": \"lookup\", \"gender\": \"F\" }\n  ],\n  \"total\": 4,\n  \"ai_calls\": 0\n}"
        }
      ]
    }
  ]
}