Erste Schritte

Anfragen & Fehler

Wie jeder Bitaloka-Endpoint Eingaben entgegennimmt und Ergebnisse meldet – einmal lernen, überall nutzen.

Base-URL

https://api.bitaloka.io/v1

Alle Endpoints sind unter /v1 versioniert und nur über HTTPS erreichbar.

Eingaben senden

• Pfad – Kennungen kommen direkt in die URL, z. B. GET /v1/nik/{nik}.
• JSON-Body – Textdienste erwarten Content-Type: application/json.
• Multipart-Formular – PDF- und Bild-Tools erwarten multipart/form-data mit file (oder mehreren files) plus Optionen als Textfelder.

Was zurückkommt

Parser, Lookups und KI liefern JSON. PDF-Tools liefern die verarbeitete Datei (application/pdf bzw. application/zip beim Aufteilen) – schreib den Body direkt auf die Festplatte.

Ungültige Eingabe ist kein Fehler

Auch eine fehlerhafte NIK erhält HTTP 200, mit valid: false und einer errors-Liste, die den Grund erklärt. Verzweige anhand von valid, nicht anhand des Statuscodes.

{
  "valid": false,
  "input": "123",
  "normalized": "123",
  "gender": null,
  "birthDate": null,
  "region": null,
  "serial": null,
  "genderConsistent": false,
  "summary": "",
  "errors": [
    {
      "code": "INVALID_FORMAT",
      "message": "NIK must be exactly 16 digits"
    }
  ],
  "warnings": []
}

Fehler

Echte Fehler verwenden Standard-HTTP-Statuscodes und einen JSON-Body {"error": "…"}.

Limits

Uploads bis 60 MB pro Anfrage. Batch-Parsing verarbeitet bis zu 100 Einträge pro Aufruf.

Aufrufe aus dem Browser