En resumen: una agencia se registra una sola vez, con su propia razón social, y se anuncia en nombre de sus clientes introduciendo el nombre de cada cliente en Nombre visible para los miembros. La agencia paga, gestiona los saldos y recibe las facturas. Los desarrolladores pueden crear y gestionar Ofertas y Eventos mediante la API REST de Agilis (https://ads.agilis.dating) con claves de API obtenidas en el Portal de Anunciantes; las claves de prueba son gratuitas y nunca se muestran a los miembros.
Para agencias
- Registre la agencia con su propia razón social. → Cómo registrarse
- Al crear una Oferta o un Evento, introduzca el nombre de su cliente en Nombre visible para los miembros. Los miembros verán el nombre del cliente, no el suyo.
- Debe contar con la autorización de cada cliente para anunciarse en su nombre. Según las Condiciones de Publicidad, la agencia es responsable de ello.
Quién paga y a quién se factura
- Paga la cuenta de su agencia, en la moneda de facturación de su agencia.
- Cada persona de su agencia tiene su propio saldo y paga con él. El saldo de la organización es la suma de todos. → Cómo funcionan los saldos
- Las facturas y los resultados están a nombre de su agencia, con una factura por pago, para que pueda refacturar a cada cliente.
- Para mantener separado el gasto de cada cliente, utilice una Oferta o un Evento por cliente y refacture a partir de su factura.
Roles del equipo
Los administradores de la organización y los anunciantes trabajan en el Portal de Anunciantes; los desarrolladores trabajan a través de la API. Los desarrolladores no pueden crear Ofertas ni Eventos en el Portal de Anunciantes, pero con sus claves de API pueden crearlos, publicarlos y pagarlos a través de la API, y su empresa es responsable del uso que se haga de sus claves. Encontrará la tabla completa en Roles y permisos del equipo.
La API REST de Agilis
- URL base: https://ads.agilis.dating
- Referencia: www.agilis.dating/api-doc, con ejemplos en cURL, Python, Node.js y PHP, y un asistente para la API
- Formatos legibles por máquina: OpenAPI 3.1 en www.agilis.dating/openapi.json, Markdown en www.agilis.dating/api-doc.md y el texto completo para herramientas de IA en www.agilis.dating/llms-full.txt
- Ofertas: consultar sus categorías y los intereses; calcular el precio de una Oferta antes de crearla; crear, consultar, pausar, reanudar y eliminar Ofertas; ver los resultados de cada Oferta
- Eventos: previsualizar, publicar, consultar, editar, cambiar de fecha, cancelar y eliminar Eventos; ver los resultados de cada Evento
Obtener una clave de API
- Inicie sesión en el Portal de Anunciantes como Administrador de la organización o Desarrollador.
- Elija Modo de prueba o Modo real con el interruptor de la parte superior de la página.
- Vaya a Claves de API → Crear clave nueva, asígnele un nombre y, si lo desea, una fecha de caducidad.
- Copie la clave de inmediato. No podrá volver a verla.
Las claves de prueba empiezan por pk_test_; las claves reales empiezan por pk_live_. Cada persona puede tener hasta 10 claves en cada modo. Rotar clave sustituye una clave de inmediato, así que actualice antes sus sistemas. Envíe la clave en la cabecera de la solicitud x-api-key: x-api-key: pk_test_….
Desarrolle de forma segura
- Desarrolle y haga pruebas con una clave
pk_test_: las Ofertas y los Eventos de prueba son gratuitos y nunca se muestran a los miembros. - Calcule el precio de una Oferta con el endpoint de estimación de precio antes de crearla.
- No guarde las claves en repositorios de código ni en navegadores; llame a la API desde su servidor.
Preguntas
¿Puede una agencia gestionar varios clientes desde una sola cuenta?
Sí. Registre la agencia una sola vez e indique el nombre del cliente en cada Oferta o Evento.
¿Puede cada cliente tener su propia factura?
Las facturas se emiten a nombre de su agencia, una por pago. A partir de ellas, puede refacturar a sus clientes.
¿Hay un entorno de pruebas?
Sí. El Modo de prueba, con claves pk_test_, es un entorno de pruebas completo. No se cobra nada y no se muestra nada a los miembros.
¿Puedo conectar herramientas de programación con IA?
Sí. Indique a su herramienta la dirección www.agilis.dating/api-doc.md o www.agilis.dating/openapi.json.
