Primeros pasos

Solicitudes y errores

Cómo recibe datos y devuelve resultados cada endpoint de Bitaloka: apréndelo una vez y úsalo en todas partes.

URL base

https://api.bitaloka.io/v1

Todos los endpoints están versionados bajo /v1 y se sirven solo por HTTPS.

Envío de datos

• Ruta: los identificadores van directamente en la URL, p. ej. GET /v1/nik/{nik}.
• Cuerpo JSON: los servicios de texto aceptan Content-Type: application/json.
• Formulario multipart: las herramientas de PDF e imágenes aceptan multipart/form-data con file (o varios files) y las opciones como campos de texto.

Qué se devuelve

Los analizadores, las consultas y la IA devuelven JSON. Las herramientas de PDF devuelven el archivo procesado (application/pdf, o application/zip al dividir): escribe el cuerpo directamente en disco.

Una entrada no válida no es un error

Un NIK mal formado igualmente recibe HTTP 200, con valid: false y una lista errors que explica el motivo. Toma decisiones según valid, no según el código de estado.

{
  "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": []
}

Errores

Los fallos reales usan códigos de estado HTTP estándar y un cuerpo JSON {"error": "…"}.

Límites

Archivos de hasta 60 MB por solicitud. El análisis por lotes admite hasta 100 elementos por llamada.

Llamadas desde el navegador