Introducción y autenticación - Documentación API - LEADGODS
Ver todos los capítulos

Referencia

Introducción y autenticación

La API de LeadGods te permite consultar desde tus propios sistemas la información de tu cuenta: publicaciones, precios y pagos. Todas las operaciones de esta documentación son de solo lectura.

URL base

Todas las rutas parten de:

https://www.leadgods.com/es/api/v1

Incluye siempre el prefijo /es. Las respuestas están en formato JSON.

Obtener tu llave

  1. Entra en Configuraciones > Desarrolladores > Apikey.
  2. Copia el valor del campo Apikey para integración con Wordpress con el botón Copiar. Es la misma llave para cualquier integración.

La llave da acceso a los datos de tu cuenta, incluidos los de tus compradores. Guárdala en el servidor y no la incluyas en páginas web ni en aplicaciones que se instalen en el dispositivo de otra persona.

Autenticar una petición

Envía la llave tal cual en la cabecera Authorization, sin anteponer Bearer ni ningún otro prefijo. Envía además una cabecera User-Agent con el nombre de tu aplicación.

Una petición, de principio a fin
  1. Tu sistemaPrepara la petición desde tu servidor.
  2. AuthorizationEnvía tu llave en la cabecera.
  3. API de LeadGodsComprueba la llave y busca tus datos.
  4. Respuesta JSONRecibes solo los datos de tu cuenta.
curl -A "MiAplicacion/1.0" \
  -H "Authorization: TU_LLAVE" \
  https://www.leadgods.com/es/api/v1/partner

Respuestas de error

Si no envías la cabecera Authorization, o la llave no corresponde a ninguna cuenta, recibes el código 403:

{ "success": false, "message": "Authorization invalid." }