En resumen: una agencia se registra una sola vez, con su propio nombre legal, y publica anuncios para sus clientes escribiendo el nombre de cada cliente en Nombre visible para los miembros. La agencia paga, administra los saldos y recibe las facturas. Los desarrolladores pueden crear y administrar ofertas y eventos mediante la API REST de Agilis (https://ads.agilis.dating) con claves de API del Portal para Anunciantes; las claves de prueba son gratuitas y lo que se crea con ellas nunca se muestra a los miembros.
Para agencias
- Registre la agencia con su propio nombre legal. → Cómo registrarse
- Al crear una oferta o un evento, escriba el nombre de su cliente en Nombre visible para los miembros. Los miembros ven el nombre del cliente, no el suyo.
- Debe contar con la autorización de cada cliente para anunciarse en su nombre. Según los Términos 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 el total. → 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, use una oferta o un evento por cliente y refacture con base en su factura.
Roles del equipo
Los administradores de la organización y los anunciantes trabajan en el Portal para Anunciantes; los desarrolladores trabajan mediante la API. Los desarrolladores no pueden crear ofertas ni eventos en el Portal para Anunciantes, pero con sus claves de API pueden crearlos, publicarlos y pagarlos mediante la API, y su negocio es responsable del uso que se haga de sus claves. La tabla completa está 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 de 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, listar, pausar, reanudar y eliminar ofertas; consultar los resultados de cada oferta
- Eventos: obtener una vista previa, publicar, listar, editar, reprogramar, cancelar y eliminar eventos; consultar los resultados de cada evento
Obtener una clave de API
- Inicie sesión en el Portal para 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 vencimiento.
- Copie la clave de inmediato. No podrá volver a verla.
Las claves de prueba empiezan con pk_test_; las claves reales empiezan con pk_live_. Cada persona puede tener hasta 10 claves en cada modo. Renovar clave reemplaza una clave de inmediato, así que primero actualice sus sistemas. Envíe la clave en el encabezado de la solicitud x-api-key: x-api-key: pk_test_….
Desarrolle de forma segura
- Desarrolle y pruebe 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.
- Mantenga las claves fuera de los repositorios de código y de los navegadores; llame a la API desde su servidor.
Preguntas
¿Puede una agencia administrar 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. Refacture a sus clientes con base en ellas.
¿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í. Configure su herramienta para que use www.agilis.dating/api-doc.md o www.agilis.dating/openapi.json.
