Guía API para Desarrolladores
¿Tienes dudas? No te preocupes, aquí encontrarás las soluciones.
Búsqueda Completa en el Sitio

Crear un Nuevo Registro

Si no estás usando formularios simples HTML para crear registros en Ragic, deberás crear solicitudes API para crear los registros. Los puntos finales (endpoints) para escribir en un formulario es el mismo para leerlos, pero envías una solicitud POST and lugar de una solicitud GET.

La API ahora es compatible con datos JSON, y la forma recomendada para hacer solicitudes HTTP.

Para agregar datos JSON (POST), debes cambiar la configuración de la pestaña Body a raw JSON, como se muestra a continuación.

Lo que necesitas hacer es usar los IDs de campos como nombres de los campos, y los valores que deseas ingresar como valores de parámetro.

Por favor nótese que el usuario deberá escribir acceso al formulario para que esto funcione.


curl -F "800001=Dunder Mifflin" \
 -F "800002=1-267-922-5599" \
 -F "800003=Jim Halpert" \
 -F "800007=Customer" \
-F "api=" \
 -H "Authorization:Basic TU_CLAVE_API_VA_AQUÍ" \
 https://www.ragic.com/demo/sales/1

El formato JSON equivalente es como a continuación:


{
    "800001": "Dunder Mifflin" 
    "800002": "1-267-922-5599" 
    "800003": "Jim Halpert" 
    "800007": "Customer
}

Si el campo es un tipo selección múltiple que puede tener múltiples valores, puedes tener múltiples parámetros con el mismo ID de campo como nombres. Si el campo es de tipo Fecha, el valor debe estar en el formato yyyy/MM/dd o yyyy/MM/dd HH:mm:ss si hay períodos de tiempo. Asique la solicitud se vería así:


curl -F "800001=Dunder Mifflin" \
 -F "800002=1-267-922-5599" \
 -F "800003=Jim Halpert" \
 -F "800007=Customer" \
 -F "800007=Reseller" \
 -F "800008=2018/12/25 23:30:00" \
 -F "api=" \
 -H "Authorization:Basic TU_CLAVE_API_VA_AQUÍ" \
 https://www.ragic.com/demo/sales/1

El formato JSON equivalente es como a continuación

los corchetes para el ID de campo 1000143 permite múltiples valores en una oración

{
    "800001": "Dunder Mifflin", 
    "800002": "1-267-922-5599", 
    "800003": "Jim Halpert",
    "800007": ["Customer", "Reseller"],
    "800008": "2018/12/25 23:30:00" 
}

Si deseas insertar datos a las subtablas el mismo tiempo, necesitarás un formato ligeramente diferente para los campos en las subtablas ya que Ragic necesita una forma para determinar si los valores de campo pertenecen al mismo registro de subtabla.

Si los valores están en la misma fila de subtabla, asígnales el mismo ID de fila negativo a cada uno. Puede ser un entero negativo. Es la única forma de determinar que están en la misma fila.

1000014_-1=Bill
1000015_-1=Manager
1000016_-1=billg@microsoft.com

1000014_-2=Satya
1000015_-2=VP
1000016_-2=satyan@microsoft.com

La solicitud completa se vería así:


curl -F "800001=Dunder Mifflin" \
 -F "800002=1-267-922-5599" \
 -F "800003=Jim Halpert" \
 -F "800007=Customer" \
 -F "800007=Reseller" \
 -F "1000014_-1=Bill" \
 -F "1000015_-1=Manager" \
 -F "1000016_-1=billg@microsoft.com" \
 -F "1000014_-2=Satya" \
 -F "1000015_-2=VP" \
 -F "1000016_-2=satyan@microsoft.com" \
-F 'api=' \
 -H "Authorization:Basic TU_CLAVE_API_VA_AQUÍ" \
 https://www.ragic.com/demo/sales/1

El formato JSON equivalente es como a continuación

{

    "800001": "Dunder Mifflin", 
    "800002": "1-267-922-5599", 
    "800003": "Jim Halpert",
    "800007": ["Customer", "Reseller"],
    "_subtable_800014": {
        "-1": {
            "1000014": "Bill",
            "1000015": "Manager",
            "1000016": "billg@microsoft.com"
        },
       "-2": {
            "1000014": "Satya",
            "1000015": "VP",
            "1000016": "satyan@microsoft.com"
        }
    }
}

Si deseas rellenar un campo de tipo archivo adjunto, asegúrate de que el tipo de codificación de la solicitud sea multipart/form-data. El equivalente HTML sería enctype='multipart/form-data'.

Con una solicitud de partes múltiples, puedes agregar tu archivo a la solicitud, y sólo pon el nombre del archivo como valor de campo.


1000088=test.jpg

Volver arriba Tabla de contenido

Iniciar Ragic Gratis

Registrarse con Google