¿Cómo anunciar tareas por API?

Resumen:

1. Requisitos
2. Anunciar tareas por API

1. Requisitos

1. Consulta nuestra documentación detallada de la API: https://docs.urbantz.com/
2. Descarga e instala la plataforma de API de tu elección. Recomendamos Postman.
3. Necesitarás la siguiente información:
   • La clave de API de tu plataforma: Encuéntrala en Administración > Plataforma > General
     
     
   • La clave de API secreta de tu flujo. Puedes encontrarla en Administración > Flujos > Integración > Anuncio y hacer clic en el botón de más.

2. Anunciar tareas por API

1. Abre Postman u otro entorno de API y selecciona el método POST
2. Inserta esta URL: https://api.urbantz.com/v2/task/
3. Inserta los siguientes encabezados:
   • Content-type: application/json
   • x-api-key: [clave de API de la plataforma]
   • x-api-secret: [clave de API del Flujo]
     Alternativamente, puedes usar Basic Auth e introducir las credenciales.
4. Inserta tu payload de solicitud en el cuerpo
5. Haz clic en ENVIAR

Urbantz devolverá un código de estado, una marca de tiempo y un identificador de anuncio, y se creará una línea de anuncio en la página de Anuncio de tu plataforma.

Nota: ten en cuenta que el campo 'contact.name' en el cuerpo de la API corresponderá a la columna 'Empresa del cliente' en la vista de Tareas, mientras que el destinatario final se refleja en el campo contact.person.

Por ejemplo, para el destinatario "John Smith" que es propietario de la empresa "Smith and Sons", los campos se rellenarán de la siguiente manera:

contact.name "Smith and Sons"

contact.person: "John Smith"