Conectores propios

Un conector propio es un servicio que describes tú mismo: cualquier API de internet que use una clave. Una vez creado, tus aplicaciones lo usan como cualquier conector de la lista, a través de Setherion, con la clave guardada en nuestros servidores.

Pulsa + arriba a la derecha en la página Connectors, luego Custom connector, y rellena:

• Details. Un Display name, una Short description para la lista, una Description más larga, una Category y una dirección de documentación opcional.
• Authentication. Cómo viaja la clave: un Bearer token, una API key in a header (tú pones el nombre de la cabecera), una API key in the address (tú pones el nombre del parámetro) o un Username and password. También puedes indicar qué se pide a las personas, como «Password». What requests to this API will look like lo muestra según eliges. Después, la API base URL, donde empieza cada petición, y una Test request: una llamada sencilla que falla sin una clave válida, como una que devuelve la cuenta actual.
• Who may use it. Only your app's team (la opción por defecto), Visitors can read o Anybody, y después los tipos de petición que las aplicaciones pueden enviar: GET lee, las demás cambian cosas. Con Visitors can read, cualquiera que abra la aplicación puede leer y solo el equipo cambia cosas. Con Anybody, todo el mundo puede hacer todas las llamadas que permitiste, y las llamadas se limitan de forma más estricta para cada visitante, así que elígela solo para una API pensada para eso.
• Agent knowledge. Opcional, y conviene escribirlo: las rutas, una petición y una respuesta para cada una, y todo lo que sea fácil de equivocar. Setherion lo lee cuando construye tus aplicaciones. Sin ello, Setherion tiene que adivinar las rutas, y una suposición puede ser errónea: indica qué ruta devuelve tu propia cuenta, por ejemplo. Nunca pegues una clave aquí.

Ninguna clave va en el formulario. Create abre la página del conector, donde añades la clave, pulsas Test connection y conectas, como con cualquier otro servicio. Edit y Delete también están en esa página. Al eliminarlo se elimina también su clave, y las aplicaciones que lo usan dejan de llegar a él al instante.

Ask. Una vez que está conectado y marcado para una aplicación, pídelo por su nombre: «Muestra mis proyectos abiertos de Acme en el panel de control». «Añade un botón que cree una tarea en Acme».

• La API base URL tiene que empezar por https:// y estar en internet público. Se rechaza una dirección dentro de una red privada, una dirección IP o una con un puerto distinto de 443, al guardarla y de nuevo en cada llamada.
• Los conectores propios son tuyos: no se prestan a los miembros de un espacio de trabajo de equipo, y un espacio de trabajo que enumera los conectores que sus aplicaciones pueden usar los deja fuera.
• Puedes tener hasta 25.
• Para una sola clave que necesita una aplicación, quizá basten Claves y secretos.