Referencia de la API de JPlug

    Manager v1.0.0 / 36 operaciones

    Especificación OpenAPIObtener clave API

    Documentación para desarrolladores

    Desarrolla con la API de JPlug

    Registra cargadores, gestiona la autorización de conductores, controla sesiones, configura la facturación y crea experiencias de carga con tu marca mediante Manager API.

    URL base de producción

    https://api.jplug.io/api
    HTTPS / RESTAutenticación con clave APIOpenAPI 3.0.311 recursos

    Novedades de esta referencia

    Actualizado
    Nuevo endpoint

    Subida de recursos del tema

    Sube imágenes PNG o JPEG a cuatro espacios de identidad de marca. Tamaño máximo: 2 MiB.

    Documentación ampliada

    Temas propiedad de organizaciones

    Configuración completa de idioma, enlaces de soporte, vistas previas sociales y parámetros de diseño claro y oscuro.

    Configuración de cargadores

    Dirección, metadatos personalizados y potencia máxima en vatios. Crear un cargador requiere un modelo de facturación propio.

    Filtros y ejemplos precisos

    Filtros de transacciones y temas, filtros adicionales de cargadores, campos de solicitud actualizados y códigos de respuesta.

    Los nombres de campo respetan las mayúsculas y minúsculas de la especificación. Al iniciar una transacción se devuelve 200 con TransactionID. See each operation for its required fields.

    Autenticación

    Incluye tu clave API en la cabecera X-API-Key de cada solicitud. Para obtener acceso, contacta con JPlug. Si ya tienes una clave, utiliza Crear clave API para crear otra clave.

    Solicitud autenticada
    curl "https://api.jplug.io/api/v1/chargeboxes" \
  -H "X-API-Key: <your-api-key>"

    Mantén las claves API en tu servidor, fuera del código del navegador y del control de versiones. El acceso a recursos sigue los permisos del usuario autenticado; las operaciones de temas requieren ser propietario de la organización.

    La mayoría de los datos se envían en JSON. Las imágenes de los temas utilizan multipart/form-data, y el endpoint de diagnóstico devuelve text/plain. Examples below are reference snippets and do not send API requests.

    Cargadores

    5 operaciones

    Registra y gestiona puntos de carga, asigna modelos de facturación y configura direcciones, metadatos y potencia máxima.

    Transacciones

    4 operaciones

    Inicia y detén sesiones de carga, consulta transacciones y filtra el historial de sesiones.

    Códigos de autorización

    5 operaciones

    Crea y gestiona etiquetas de identificación para autorizar sesiones de carga.

    Modelos de facturación

    5 operaciones

    Crea, consulta, actualiza y elimina modelos de facturación para tus cargadores.

    Temas

    5 operaciones

    Configura la identidad de marca de tus organizaciones, incluidos el idioma, los enlaces de soporte, las imágenes y los parámetros de diseño claro y oscuro.

    Recursos de temas

    1 operation

    Sube logotipos, iconos y vistas previas para redes sociales de un tema que te pertenezca.

    Organizaciones

    3 operaciones

    Crea organizaciones y consulta las disponibles para tu cuenta.

    Claves API

    3 operaciones

    Lista, crea y revoca claves API asociadas a tu cuenta.

    Facturas

    3 operaciones

    Consulta facturas y totales agrupados por tipo. El listado admite filtros metadata[key]; la especificación no enumera todos los parámetros de filtrado.

    Jurisdicciones fiscales

    1 operation

    Consulta la lista de jurisdicciones fiscales.

    Diagnóstico

    1 operation

    Inspecciona la información de diagnóstico en texto sin formato de una solicitud autenticada.