Crear un registro

Para crear un registro, utilice un método HTTP POST con el punto de conexión de API records y especifique el nombre de la base de datos y la presentación.

Método HTTP

POST

URL

/fmi/data/versión/databases/nombre-base-de-datos/layouts/nombre-presentación/records

versión: la versión de FileMaker Data API solicitada puede utilizar v1, v2 o vLatest.

nombre-base-de-datos: el nombre de la base de datos alojada.

nombre-presentación: el nombre de la presentación que se utilizará como contexto para la creación del registro.

Encabezado HTTP

Content-Type: application/json

Authorization: Bearer token-sesión, donde token-sesión es el valor exclusivo de X-FM-Data-Access-Token para la sesión de la base de datos.
Parámetros

Registre datos en formato JSON que contengan pares de campo y valor que especifiquen valores para los campos incluidos en la presentación de destino. Los datos pueden especificar registros relacionados o portales que se encuentran en la presentación mediante la especificación portalData. Un nombre de portal puede ser el nombre del objeto que se muestra en el Inspector de FileMaker Pro o el nombre de la tabla relacionada.

Por ejemplo:

Copiar 
{"fieldData":
  { 
    "String Field": "valor_1", 
    "Number Field": 99.99, 
    "repetitionField(1)" : "ValorCampo" 
  } 
}

Nota   Para crear un registro vacío con valores predeterminados para cada campo, especifique un objeto de datos vacío en formato JSON como parámetro.

Por ejemplo:

Copiar 
{"fieldData": 
  { 
  } 
}
Puede ejecutar guiones de FileMaker como parte de esta solicitud. Para ello, incluya los parámetros script.prerequest, script.presort y script en el cuerpo de la solicitud. Consulte Ejecutar guiones de FileMaker.
Respuesta

El ID del registro que se ha creado y una matriz de mensajes que muestran el código de error 0.

Por ejemplo:

Copiar 
{
    "response": { 
        "recordId":"147", 
        "modId":"0"
    },
    "messages": [ 
        {
            "code": "0",
            "message":"OK"
        }
    ]
}

Consulte Respuestas de error.

Notas 

  • Al crear registros mediante FileMaker Data API, se debe aplicar la validación de campos. Si los datos no superan la validación de campos, recibirá un mensaje de error y no se creará el registro.