Guía técnica
API, feed y avisos del afiliado
Tu clave afi_, tus cifras, tus enlaces, el feed atribuido con token y los avisos firmados de cada conversión.
La clave del afiliado
Se genera en tu panel, en Recursos, y empieza por afi_. Toda reserva creada con ella queda atribuida a tu cuenta sin rellenar nada, y el presupuesto te devuelve el precio público: un afiliado recomienda, no revende.
Regenerarla o revocarla invalida la anterior y el token del feed.
Lo que puedes leer y crear
GET /api/v1/afiliado: tus cifras y tu saldo. GET /api/v1/afiliado/conversiones: tus conversiones, para conciliar. GET y POST /api/v1/afiliado/enlaces: tus enlaces medidos.
GET /api/v1/afiliado/articulo: el borrador de un artículo de un trayecto con los datos del catálogo; es lo que usa el plugin de WordPress, y nunca se publica solo.
El feed atribuido
GET /api/v1/afiliado/feed/{csv|xml|json} da el catálogo con tus enlaces (tipo=catalogo) o tus conversiones (tipo=conversiones), cada enlace por tu /r/<código> y con tu subid.
Para herramientas que no mandan cabeceras (Google Sheets, importadores de WordPress) usa el token de feed fd_ del panel en ?token=: es de solo lectura y deja de valer al regenerar la clave.
text
Avisos de conversión (postback)
En Mi cuenta pones una URL https y te damos un secreto. Te avisamos de conversion.creada, conversion.aprobada, conversion.rechazada y liquidacion.pagada, sin datos del pasajero.
Se verifica igual que los avisos de la API: X-VTC-Signature es sha256= más el HMAC-SHA256 en hexadecimal de <X-VTC-Timestamp>.<cuerpo> con tu secreto (guía de avisos).