{
 "openapi": "3.1.0",
 "info": {
  "title": "SAPIR 861 open API",
  "version": "1",
  "description": "Hebrew names in Hebrew letters, standard gematria, Torah words by number, and equality checks. Read-only, no key. Limits: 60 requests/min and 600/hour per IP. Attribution link to https://sapir861.com required. Torah text: Westminster Leningrad Codex (CC BY 4.0).",
  "contact": {
   "url": "https://sapir861.com/developers"
  }
 },
 "servers": [
  {
   "url": "https://sapir861.com"
  }
 ],
 "paths": {
  "/api/tr": {
   "get": {
    "operationId": "hebrewName",
    "summary": "A name in Hebrew letters, with sum and a Torah word",
    "parameters": [
     {
      "name": "n",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "lang",
      "in": "query",
      "schema": {
       "type": "string",
       "enum": [
        "en",
        "ru",
        "he",
        "es",
        "pt",
        "fr",
        "ar",
        "el"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  },
  "/api/word": {
   "get": {
    "operationId": "torahWord",
    "summary": "A Torah word for a number",
    "parameters": [
     {
      "name": "g",
      "in": "query",
      "required": true,
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "lang",
      "in": "query",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  },
  "/api/check": {
   "get": {
    "operationId": "checkEquality",
    "summary": "Check a gematria equality claim",
    "parameters": [
     {
      "name": "a",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "b",
      "in": "query",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "lang",
      "in": "query",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  },
  "/api/cite": {
   "get": {
    "operationId": "citationRecord",
    "summary": "Permanent citation record with status verified/calculated/rejected, hash and stable ID",
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "b",
      "in": "query",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "lang",
      "in": "query",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  },
  "/api/odds": {
   "get": {
    "operationId": "baselineOdds",
    "summary": "Baseline frequency of a gematria value in the Torah word index and expected chance matches",
    "parameters": [
     {
      "name": "n",
      "in": "query",
      "required": true,
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "tries",
      "in": "query",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  },
  "/api/provenance": {
   "get": {
    "operationId": "provenanceRecord",
    "summary": "Verifiable provenance record for a Hebrew word, name or number",
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "lang",
      "in": "query",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  },
  "/api/detect": {
   "get": {
    "operationId": "coincidenceCheck",
    "summary": "Check a viral number-coincidence claim",
    "parameters": [
     {
      "name": "c",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "lang",
      "in": "query",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  },
  "/api/day": {
   "get": {
    "operationId": "dayNumber",
    "summary": "Today's number and verse",
    "responses": {
     "200": {
      "description": "OK"
     }
    }
   }
  }
 }
}