Crear recurso

Crear un registro en un recurso

Crea un registro enviando sus campos como formulario. Ejemplo con una ciudad.

Aplicabilidad: API versión 3 · Plan Profesional, con la API activada en el servicio.

Petición

export BEPLY_URL="https://<TU_SERVICIO>.beply.es"
export BEPLY_TOKEN="<TU_CLAVE_API>"

curl -s -X POST "$BEPLY_URL/api/3/ciudades" -H "Token: $BEPLY_TOKEN" \
  --data-urlencode "ciudad=Ciudad de ejemplo" \
  --data-urlencode "idprovincia=1"

Para un campo vacío envía null. Si no envías la clave primaria, el programa la asigna.

Respuesta correcta

HTTP 200 {"ok": "Registro actualizado correctamente.", "data": {…}}. Guarda la clave primaria de data.

Ejemplo fallido

HTTP 400 {"error": "Registro duplicado", "data": {…}} si envías una clave primaria que ya existe; no se crea nada. HTTP 400 «Ha ocurrido un error mientras se guardaban los datos - …» si falla una validación.

Evitar duplicados

Si la petición se corta sin respuesta, busca el registro antes de repetirla. Para documentos con líneas usa las funciones de Facturas.

Más casos en Errores y validaciones.