SDK PHP
Una libreria instalable mediante composer que le permitirá implementar todas las APIs de ZPK
Instalación mediante composer (recomendada)
Recomendamos usar la versión composer para que su proyecto siempre pueda actualizar a la última versión del SDK.
Estableciendo la aplicación
Todas las llamadas a la API deben especificar a que aplicación se realizan las llamadas.
La clase zpkApplication determina una aplicación específica mediante su application_id y una api_key de autenticación.
Ejemplos incluidos
Ejemplos incluidos en la carpeta de instalación
Consulte los ejemplos disponibles
Hay varios ejemplos de uso del SDK en el directorio /examples
Puede ejecutar los ejemplos dirigiéndose al directorio del ejemplo y ejecutandolo directamente desde la terminal.
ZPK Translate
Usando el SDK para traducir textos y detectar idiomas mediante la API de ZPK Translate
Traducción con ZPK Translate
Llame a la API de traducción inicializando un traductor, en este ejemplo puede verse una solicitud para traducir 2 frases. En el primer caso el idioma origen será autodetectado. En el segundo indicamos el idioma origen.
Obteniendo la lista de idiomas
Puede obtener toda la lista de idiomas disponibles en nuestra API de traducción.
Tenga en cuenta que este request también tiene un coste, recomendamos hacer cache de estos datos y no realizar esta consulta mas de una vez cada 48 horas.
Vin Analyzer
Extraiga datos de números de bastidor VIN, o bien autocorrija números VIN incorrectos.
Analizando números VIN
Llame a la API de análisis inicializando un analizador de VINS
Filtrando VINs por zona, país, fabricante, o marca.
Nuestra API permite establecer filtros que alterarán la puntuación de los VIN detectados. Estos filtros se pueden usar para excluir VINs que cumplan con uno o más criterios, o bien para darles prioridad a otros VIN en caso de que un número incorrecto pueda ser corregido a diferentes VINs válidos.
En el siguiente ejemplo se enviará un VIN con los tres primeros dígitos VS5 que pertenece al fabricante 'renault', sin establecer ningún filtro. La API de ZPK retornará los datos de un vehículo del fabricante renault.
En un segundo envío, establecemos un filtro que penaliza la marca renault. La API determinará que el VIN enviado contiene un error de escritura debido a que hemos penalizado renault, y retornara un vehículo de la marca Seat debido a que su código de fabricante es VSS, y VS5 es ópticamente muy parecido a VS5
Obteniendo paises, fabricantes, y marcas.
Para obtener todos estos datos de forma actualizada puede realizar la siguiente llamada en el SDK.
Tenga en cuenta que estos requests también tienen un coste, recomendamos hacer caché de estos datos ya que se añaden y modifican solo puntualmente.
VIN OCR
Extraiga datos de números de bastidor VIN, o bien autocorrija números VIN incorrectos a partir de imágenes y documentos escaneados.
Analizando una imágen para extraer el VIN
Llame a la API de detección OCR inicializando un OCR de VINS
Usando filtros de puntuación para un reconocimiento óptimo.
Al igual que la api de VinAnalyzer, VINOCR puede usar filtros que alterarán la puntuación interna de los posibles números VIN considerados durante el reconocimiento óptico.
En este ejemplo se enviará una imagen que podría coincidir con múltiples fabricantes:
En este ejemplo enviaremos un número VIN al que le falta el primer carácter, y por lo tanto podría pertenecer a diferentes fabricantes. Para ese ejemplo supondremos que trabajamos con una flota de vehículos europeos.
Usaremos un filtro para dar mayor puntuación a los números VIN de vehículos europeos, forzando a la API a otorgar una puntuación de preferencia más alta a estos vehículos
Obteniendo todos los VINs considerados
Puede solicitar a la API que retorne junto a los resultados, todos los VIN que a tenido en cuenta a la hora de determinar un VIN correcto. Eso puede ayudarle a crear filtros específicos para su caso de uso.
Para ello simplemente llamaremos al método includeConsideredVins()
Obteniendo fabricantes, marcas, y países.
Su aplicación puede consultar los fabricantes, marcas, modelos y países que esta API puede retornar con una llamada a diferentes métodos.
Tenga en cuenta que consultar esta información también tiene un coste, recomendamos hacer caché de estos datos para minimizar las llamadas a la API.
ZPK SMS
Envie mensajes de texto SMS a teléfonos móviles, 216 países soportados.
Enviar un SMS
Inicialice un SmsRequest para enviar uno o más mensajes SMS
<?php
$application = new zpkApplication($application_id,$api_key);
$sendRequest = new zpkSmsSendingRequest($application);
$sms = new zpkSMS("+34634568046");
$sms->setFrom("First");
$sms->setMessage("SMS test message, the first one :)");
$sendRequest->add($sms);
$response = $r->send();
var_dump($response);
Consultar precios de envío
Para consultar los precios actuales de envío inicialice un PriceRequest
<?php
// Initialize zpk application
$application = new zpkApplication($application_id,$api_key);
// Price request
$pRequest = new zpkSmsPriceRequest( $application );
$data = $pRequqest->getPrices();
echo json_encode($data,JSON_PRETTY_PRINT);
Plate Scanner OCR
Extraiga matrículas de vehículos de imágenes y documentos
Extrayendo la matrícula de una imágen
Llame a la API de detección OCR inicializando un escaneador de matrícula.
Especificando zonas
Puede enviar una o mas zonas geógraficas que se usarán como una sugerencia en la API en el momento de la detección con el método setZoneHints.
Regiones en modo estricto
Con una llamada a enableStrictRegions() podemos forzar a la API a considerar única y exclusivamente las matrículas de las zonas especificadas anteriormente, descartando todas las matrículas que no cumplan con el patrón de las zonas especificadas.
Obteniendo todas las zonas
Una llamada a getAllRegions() retornará una lista de todas las zonas soportadas por la API. Recuerde que esta petición tiene un coste, recomendamos guardar estos datos en cache.
ZPK IA Images
Genere imagenes con inteligencia artificial en sus aplicaciones PHP
Solicitar con espera a generación
Llame a la api de generacion inicializando un generador, en este ejemplo puede verse una solicitud para generar dos imagenes mediante generate().
La aplicación esperará hasta que todas las imagenes hayan sido generadas en el servidor y luego mostrará la URL de descarga.
Solicitar estado de generación
Solicite la generación de imagenes, luego puede solicitar el estado de las imagenes hasta que estas hayan sido generadas.
Al hacer una solicitud de generación obtenemos su id único único mediante getUniqueRequestId(), eso nos permite realizar posteriores llamadas de solicitud de estado con un zpkImageStatusRequest llamando al método requestStatus( $id_unico ).
Usted puede guardar el id único de generación (en su base de datos por ejemplo) para procesar el resultado en otra parte de su aplicación (un cron job, por ejemplo).
Solicitar imagenes y esperar callback
Puede solicitar imagenes y procesarlas cuando hayan sido generadas en nuestros servidores mediante el uso de callbacks.
Cuando todas las imagenes hayan sido procesadas se enviará una solicitud HTTP a la URL indicada, con los datos de las solicitudes y las URL de descarga de las imagenes.
En este ejemplo hemos usado una dirección URL de zpk.systems para hacer tests de requests de callback, usted debe proporcionar una URL HTTPS apuntando a sus propios servidores.
Precios
Todos los precios de las API de ZPK System son bajo demanda, usted paga solo por el uso de las API. Sin cuotas mensuales.
API | Precio |
---|---|
Vin OCR |
VinOcr
EUR 0,003 Por cada imágen escaneada |
Vin Analyzer |
VinAnalyzer
EUR 0,004 Por cada solicitud de un VIN
EUR 0,003 Por cada VIN extra en la misma solicitud
|
IA Images |
IA Images
A partir de 0,038 €
|
ZPK Translate |
ZPK Translate
Primeros 600.000 caracteres al mes gratis
1 EUR por cada 62.500 caracteres
|
HTML To Image |
HTML To Image
0,0020 euros por captura de página.
|
API de Moderación |
API de Moderación
EUR 0,0010 por moderación (hasta 500 caracteres)
EUR 0,0050 por consulta a estadisticas de una fuente de mensajes. |
Plate Scanner |
PlateScanner
EUR 0,001 por imagen escaneada
EUR 0,010 por cada soclicitud de listado completo de regiones
|
ZPK SMS |
ZPK SMS
|
Obtener crédito
Al crear una cuenta en ZPK Systems y validar sus datos, se añadirán gratuitamente 2,00 euros a su cuenta para que pueda realizar tests.
Cree una cuenta ahora, y obtenga crédito gratuito para realizar la implementación. Si ya está registrado, acceda a su panel para gestionar su crédito disponible o añadir fondos.
¿Su proyecto no usa PHP?
Nuestra API puede ser implementada en multitud de lenguajes.
Si su proyecto no usa PHP puede usar la API HTTP. Nuestras APIS funcionan con una comunicación HTTP basada en solicitudes y respuestas JSON. Facilitando la implementación en prácticamente cualquier lenguaje de programación.
Consulte la API http, endpoints, y parámetros en la documentación específica de cada API.