Cómo funciona el parámetro callback_url

El parámetro callback_url está diseñado para enviar datos a la URL del usuario. El parámetro se especifica directamente en la solicitud POST al crear una tarea de actualización de datos. Después de completar la solicitud POST, los datos se actualizarán y se enviarán a la URL especificada. Por su parte, el usuario puede utilizar inmediatamente los datos para sus propios fines.

Así, el parámetro callback_url te permite simplificar la integración y reducir el número de solicitudes, así como acelerar y automatizar la recuperación de datos.

En el parámetro callback_url necesitas especificar un enlace al que se enviarán los resultados de la consulta. En el ejemplo a continuación, hemos indicado un enlace a webhook.site.

Vamos a webhook.site y obtenemos un enlace único que aceptará solicitudes de nuestra parte.

1. El enlace a la página donde se mostrarán todas nuestras solicitudes: https://webhook.site/#!/a66b7678-5dc3-4f05-a4ac-a197cc602228/1a9dcb8d-808c-432d-a01d-adccb0fcfe59/1
2. El enlace para enviar los resultados: https://webhook.site/a66b7678-5dc3-4f05-a4ac-a197cc602228

Como ejemplo, hagamos una solicitud para buscar las últimas 25 publicaciones en Facebook utilizando la palabra clave "toyota". También especificamos el enlace nº 2 en webhook.site en el parámetro callback_url.

Enviamos una solicitud POST:

https://api.data365.co/v1.1/facebook/search/toyota/posts/latest/update?max_posts=25&callback_url=https://webhook.site/a66b7678-5dc3-4f05-a4ac-a197cc602228&access_token=YOUR_TOKEN

En el postman, se ve así:

Un par de minutos de espera y luego obtenemos la respuesta que llega al enlace de webhook.site. La respuesta contiene una lista de las últimas 25 publicaciones, para la palabra clave "toyota".

Como puedes ver, tomó aproximadamente 6 minutos completar la solicitud.

De manera similar, el callback_url se puede utilizar en todas las solicitudes POST. El enlace de webhook se utilizó solo como un ejemplo. La prioridad principal es hacer la configuración de tu lado para que tu aplicación pueda recibir respuestas JSON de nuestra API.