Documentación

Ofertas

Lo que tus campañas venden. Un socio con portal de certificados encuentra aquí, sin configurar nada, cada producto que su portal vende —cada duración y tipo de certificado al precio que cobra, cada paquete de firmas con precio— con su página de compra en el portal del socio como destino; la lista se actualiza cuando el catálogo del portal cambia. La venta que el portal registra cuenta para la campaña del socio.

Listar ofertas#

GET /api/v1/ad_offerings Bearer

De la más antigua a la más reciente, por páginas: limit (1 a 100, 25 por defecto) y after (el next_cursor de la página anterior).

Parámetros

status string

active o archived .

limit integer

Cuántos por página, de 1 a 100.

after string

El next_cursor de la página anterior.

Devuelve · 200 con la lista ( data , has_more , next_cursor ) · 422 con un filtro inválido.

cURL
curl "https://edge.datil.com/api/v1/ad_offerings" \
  -H "Authorization: Bearer $DATIL_API_KEY"
Respuesta · 200
{
  "object": "list",
  "data": [
    {
      "id": "5d2c1f0e-8a4b-4c3d-9e6f-1a2b3c4d5e6f",
      "object": "offering",
      "external_key": "portal.cert.y1.persona_natural",
      "label": "Firma electrónica 1 año · persona natural",
      "product_key": "portal.cert.y1.persona_natural",
      "status": "active",
      "price": "24.99",
      "currency": "USD",
      "conversion_event": "paid_first_invoice",
      "landing_url": "https://mi-socio.datil.id/comprar?type=persona_natural&validity=y1",
      "source": "portal",
      "created_at": "2026-09-27T14:00:00Z",
      "updated_at": "2026-09-27T14:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Consultar una oferta#

GET /api/v1/ad_offerings/:id Bearer

Un objeto de tu organización, con su estado de entrega.

Parámetros

id string requerido

El id del objeto.

Devuelve · 200 con el objeto · 404 not_found para uno que no es de tu organización.

cURL
curl "https://edge.datil.com/api/v1/ad_offerings/7b0f6a52-3c1e-4d7e-9a57-0c1f5c2e9b10" \
  -H "Authorization: Bearer $DATIL_API_KEY"
Respuesta · 200
{
  "id": "5d2c1f0e-8a4b-4c3d-9e6f-1a2b3c4d5e6f",
  "object": "offering",
  "external_key": "portal.cert.y1.persona_natural",
  "label": "Firma electrónica 1 año · persona natural",
  "product_key": "portal.cert.y1.persona_natural",
  "status": "active",
  "price": "24.99",
  "currency": "USD",
  "conversion_event": "paid_first_invoice",
  "landing_url": "https://mi-socio.datil.id/comprar?type=persona_natural&validity=y1",
  "source": "portal",
  "created_at": "2026-09-27T14:00:00Z",
  "updated_at": "2026-09-27T14:00:00Z"
}
Sin conexión — reintentando…

Esenciales

Sesión, seguridad, idioma y tema. Sin ellas el sitio no funciona.

Siempre activas