DATATAP / Crear un perfil
Crear un perfil
Un archivo JSON. Tu propio formulario.
Creá un perfil con tu IA
Pegá el prompt en tu asistente de IA junto con un cURL, un Swagger/OpenAPI, una colección de Postman o una descripción de tu API. Quitá las claves reales y los datos sensibles antes de compartir el material.
Ver prompt completo
1. Elegí un ejemplo
Los ejemplos usan una API de ejemplo. Reemplazá la URL por tu endpoint HTTPS antes de enviar.
2. Definí el destino y los campos
Guardá el archivo como texto UTF-8 con extensión .datatap. label es lo que ve la persona; key es el nombre enviado a tu API.
{
"version": 1,
"name": "Registro rápido",
"request": {
"url": "https://api.example.com/records",
"method": "POST",
"auth": {
"type": "none"
},
"encoding": "json",
"emptyFields": "omit"
},
"inputs": [
{
"key": "code",
"type": "text",
"label": "Código",
"required": true
},
{
"key": "quantity",
"type": "number",
"label": "Cantidad",
"required": true
}
],
"response": {
"type": "none"
}
}El contrato, sin sorpresas
| Propiedad | Qué configurar |
|---|---|
version | Siempre 1. |
name | Nombre inicial del perfil. Cada importación crea una copia nueva, que se puede renombrar o eliminar. |
request.url | URL HTTPS absoluta de tu API. Admite query fija y segmentos dinámicos como {productId}. No se siguen redirecciones. |
request.method / encoding | POST, PUT o PATCH con json o multipart. GET exige query y no admite imágenes. En iOS, el endpoint GET debe admitir HTTP/1.1. |
request.emptyFields | omit omite campos opcionales vacíos. null envía JSON null, o el texto literal null en multipart/query. |
inputs | Lista plana no vacía. Cada campo tiene key, type, label y required (booleano). Las claves son únicas y cumplen ^[A-Za-z_][A-Za-z0-9_]*$. No hay objetos anidados. |
response | Usá exactamente {"type":"none"}. Un HTTP 2xx confirma el envío y limpia el formulario; el cuerpo se ignora. Ante un error se conservan los valores. |
Tipos y listas
text, number, date, boolean, enum, image.
Agregá [] al tipo para permitir varios valores, por ejemplo image[] o date[]. En JSON se envía un array; en multipart o query se repite la misma clave, sin sufijo []. Los valores 0 y false son datos presentes, no campos vacíos. Los obligatorios se comprueban al enviar.
Los códigos QR y de barras completan campos de texto, sin abrir las URLs escaneadas. Las fechas se envían como YYYY-MM-DD, sin hora ni zona horaria. Los números JSON usan punto decimal y los booleanos usan true/false.
Opciones fijas
Los tipos enum y enum[] requieren options con una etiqueta visible y un valor enviado a la API. Todos los valores del campo deben ser texto no vacío o todos numéricos finitos, sin duplicados. No se descargan opciones desde el servidor.
{
"key": "priority",
"type": "enum",
"label": "Prioridad",
"required": true,
"options": [
{
"label": "Normal",
"value": 1
},
{
"label": "Alta",
"value": 2
}
]
}Autenticación
Sin autenticación: {"type":"none"}. Para API key usá el objeto siguiente. Nunca incluyas la clave real en el archivo: cada persona la ingresa al importar. Se guarda en Keychain (iOS) o cifrada con Android Keystore.
{"type":"apiKey","in":"header","name":"X-API-Key"}También se admite in: "query" si la API lo requiere. Para un token Bearer usá {"type":"bearer"}. La app agrega la cabecera Authorization.
Destinos, validaciones y UUID
Estas opciones requieren DataTap 0.2.0 o posterior. El archivo sigue usando "version": 1.
- Cada campo puede incluir
destinationconinigual apath,query,headerobody. El nombrenametoma el valor dekeypor defecto. Sindestination, el encoding determina el destino. - Cada parámetro de ruta ocupa un segmento completo y se completa con un campo escalar obligatorio. La query admite listas y puede acompañar un cuerpo. Las cabeceras admiten valores escalares ASCII imprimibles y se omiten si están vacías. DataTap valida colisiones por destino y cabeceras reservadas.
- Usá
integer,minymaxpara números, yminLengthymaxLengthpara texto. Los límites son inclusivos y se aplican por elemento. Para exigir texto con contenido, combinárequired: trueyminLength: 1. - La lista opcional
request.generatedpuede enviar un UUID en una cabecera o en el cuerpo. Cada envío manual genera claves nuevas y puede producir otra operación.
{
"generated": [
{
"type": "uuid",
"destination": {
"in": "header",
"name": "Idempotency-Key"
}
}
]
}Fotos y tamaño de envío
Si hay imágenes, agregá images en la raíz. Se toman con cámara o se eligen en la galería. En multipart se envían como archivos; en JSON, como Base64 sin prefijo data URL. Se procesan localmente a JPEG con calidad 90 %.
{"images":{"resize":{"mode":"fit","maxWidth":1280,"maxHeight":1280}}}El ajuste conserva proporción y no amplía imágenes pequeñas. Para conservar dimensiones usá {"resize":{"mode":"original"}}. Los límites de fit son enteros de 1 a 8192 px. El límite de envío es 20 MiB, incluido Base64/multipart; el de un perfil es 1 MiB.
3. Compartí e importá
Distribuí el archivo o publicalo en una URL HTTPS directa. Podés convertir esa URL en QR para importarlo con la cámara; también podés usar el JSON compacto literal si entra en el QR. El MIME recomendado es application/vnd.datatap. En DataTap: Importar perfil → archivo, URL o QR.
Revisá siempre el servidor antes de importar. Probá con datos ficticios. No hay borradores al cerrar ni reintentos automáticos: si la conexión falla después de que tu API recibió el registro, verificá el servidor antes de reenviar.