Con el lanzamiento de la nueva API de Envato Marketplace, los desarrolladores externos ahora tienen acceso a una gran cantidad de información para crear todo tipo de aplicaciones útiles. Este tutorial te enseñará cómo hacer tu propia aplicación para iPhone usando datos de la nueva API. Incluso si no tienes un iPhone, puedes aprender lo básico sobre el uso de PHP y JSON.
La aplicación que vamos a crear se basa en mi aplicación para iPhone, Envato Marketplace Mobile. Si bien no volveremos a crear la aplicación completa, este tutorial le dará una idea general de cómo se creó. Este tutorial está dirigido a principiantes en PHP y JSON y sirve como base para crear aplicaciones PHP más avanzadas.
Antes de que podamos comenzar a recuperar datos utilizando la API, debemos aprender cómo acceder a ella. La API se divide en 5 partes:
Para más información sobre la API, haga clic aquí..
Ahora que sabemos lo que se requiere para acceder a la API, estamos listos para ponerlo en práctica. Ya que queremos que otros usen nuestra increíble aplicación, necesitamos obtener un nombre de usuario y una clave de API sobre la marcha; Así que vamos a recuperar algunas variables de PHP desde el navegador.
if (isset ($ _ GET ['user']) && $ _GET ['user']! = "") $ userName = $ _GET ['user']; if (isset ($ _ GET ['key']) && $ _GET ['key']! = "") $ apiKey = $ _GET ['key']; else echo '¡Tecla Api no configurada!'; salida; else else echo '¡El nombre de usuario no está configurado!'; salida;
El código anterior verifica si las variables usuario y llave se han establecido - y sale si no lo han hecho. También verifica que la variable global no esté vacía.
Ahora que tenemos la información requerida, podemos seguir adelante y usarla para recuperar nuestros datos. Para hacer esto, simplemente crearemos una URL utilizando el formato descrito en la introducción..
// Crea una cadena que se utilizará para acceder a la API $ json_url = "http://marketplace.envato.com/api/edge/".$userName."/".$apiKey."/vitals+recent-sales .json ";
Observe que estamos usando la versión "perimetral" y estamos usando nuestras variables anteriores para el nombre de usuario y la clave api. Finalmente, vamos a recuperar el partes vitales y ventas recientes conjuntos de datos en el formato JSON.
Ahora que hemos creado nuestra url para acceder a la API, debemos leer su contenido para que puedan pasarse a la función json_decode, que requiere un conjunto de datos json real, no solo una url. Entonces, sigamos adelante y usemos el file_get_contents () Función para leer los contenidos de la url..
// Obtener el contenido de la cadena $ json_url $ json_contents = file_get_contents ($ json_url); // Un pequeño error al verificar si (! $ Json_contents) echo "Error: No se pudo leer el archivo JSON. Verifique su nombre de usuario y la clave api."; salida;
Finalmente estamos listos para convertir los datos JSON en una matriz para que podamos usarlos en nuestra aplicación. Para llevar a cabo esta tarea utilizaremos el json_decode () función que tomará los datos de nuestra $ json_contents variable y la salida a una matriz.
// Producir nuestros datos en una matriz $ json_data = json_decode ($ json_contents, true);
Estamos usando dos parámetros en esta función, el primero es la cadena que queremos decodificar, y el segundo le dice a la función que genere los datos como una matriz. ¡Eso es! Ahora estamos listos para mostrar nuestros datos al usuario..
Hemos recuperado nuestros datos y ahora es el momento de mostrarlos al usuario. En aras de la simplicidad, agregaremos nuestro código HTML de frontend al mismo archivo que nuestro código PHP. Así que adelante, agregue el código de documento HTML estándar debajo de su código PHP.
Aplicación para iPhone My Nettuts - Aplicación para iPhone My Nettuts
Note que en el
Continuemos y agreguemos un div simple que muestre el nombre de usuario recuperado de la API. Podríamos hacer esto usando la variable $ userName como usamos en el título de la página, sin embargo, usar JSON es más emocionante.
Lo que hace el código anterior es recuperar el nombre de usuario desde el partes vitales matriz, que es una matriz dentro de nuestra $ json_data matriz que se creó anteriormente. Tiene sentido?
Aquí está la estructura de la matriz utilizada en el ejemplo de API: Array ([vitals] => Array ([username] => ryan [balance] => 32.75))
A continuación, queremos mostrar al usuario su saldo. Esto se hace de la misma manera que mostramos el nombre de usuario. Esta vez, sin embargo, simplemente cambiaremos de "nombre de usuario" a "saldo". El resto es simplemente para el diseño y el estilo..
"; $ count = $ count + 1; else break;?>Saldo: $Ventas recientes:
Listado de ventas recientes
Lo último en nuestra agenda es mostrar las ventas más recientes para un usuario. Esto es un poco más complicado que en los ejemplos anteriores, sin embargo, si alguna vez ha trabajado con matrices, debería poder manejarlo.
Vendido ". $ Valor ['item']." para $ ". $ valor ['cantidad']."
Hay mucho que digerir aquí, así que comencemos con el para cada declaración. Primero creamos un $ salesArray desde la matriz de ventas recientes dentro de $ json_data. Esto no es necesario, pero creo que se ve más limpio. La sentencia foreach crea un $ valor para cada fila en el $ salesArray array y nos permite extraer información de cada fila. Así que, básicamente, usa $ valor para obtener datos de la fila a medida que la instrucción foreach se desplaza.
El siguiente es el código que se ejecuta cada vez que la instrucción foreach pasa por una fila. En lugar de mostrar todas las ventas recientes, solo quiero enumerar diez, por lo que, si el número de filas marcadas supera las diez, se romperá el ciclo. Para cambiar el número de filas por las que pasa la declaración, simplemente cambie diez al número que desee. En realidad, mostrar las filas es bastante simple, ya que solo requiere hacer eco de cada fila dentro de un div con un pequeño icono. Usamos el $ valor para acceder a la información de venta de la matriz. Nosotros tiramos "ít", cual es el titulo del articulo y "cantidad" que es la cantidad que el autor hizo en la venta. Finalmente "$ count + 1" solo aumenta el recuento de filas por las que ha pasado la instrucción. ¡Ahora deberías estar listo! Intente cargar el archivo en un servidor de prueba y ver si funciona!
Si no tiene una cuenta de Envato Marketplace, puede usar el inicio de sesión de ejemplo:
Bueno, nuestra nueva aplicación funciona muy bien, pero se ve mal, lo que significa que es hora de romper un poco de CSS. Supongo que sabes lo suficiente como para entender el siguiente código, ya que no voy a entrar en él excepto por algunas cosas. #navegador es utilizado por el iPhone / Touch para asegurarse de que si la página es demasiado pequeña llenará la pantalla. body.lanscape #browser hace lo mismo, sin embargo, es para cuando el navegador está en modo horizontal.
cuerpo fondo: #efefef; margen: 0px; relleno: 0px; Familia tipográfica: Helvetica; -webkit-touch-callout: ninguno; -webkit-text-size-adjust: none; ancho: 100%; color: # 2a2a2a; #browser / * aseguramos que siempre llenemos toda la pantalla * / min-height: 416px; body.landscape #browser min-height: 268px; h3 margen inferior: 5px; p margen: 0 0 5px 0; / * Layout * / #header padding: 10px 5px 5px; altura: 30px; color: #fff; tamaño de letra: 22px; fondo: url (header_bg.jpg) repeat-x; # nombre de usuario font-size: 18px; font-weight: negrita; transformación de texto: mayúsculas; relleno: 5px; / * WebKit admite text-shadow ... así que, ¿por qué no hacer que se vea bonito? * / Text-shadow: 0 1px 0 rgba (0, 0, 0, 0.5); color: #fff; fondo: # 498929; borde superior: 1px sólido # 85c952; borde inferior: 1px sólido # 34661c; #content padding: 5px; relleno superior: 10px; .icon vertical-align: text-top; margen derecho: 5px; .line padding-bottom: 5px; borde inferior: 1px sólido #cccccc; margen inferior: 5px;
Es hora de que tu gran aplicación finalmente sea compatible con iPhone. Esto es realmente fácil e involucra solo una línea de código.
Simplemente agregue el código anterior justo debajo de
Bueno ... ¡ya hemos terminado! Puedes ver el producto terminado a continuación..
Has llegado hasta el final. Espero que esta sea una buena introducción para aquellos que aún están en las etapas iniciales de uso de PHP y JSON. Ahora estás listo para crear tu propia aplicación asesina utilizando la API y JSON en general..
Ahora recuerde, este tutorial es para principiantes y para aquellos que necesitan un inicio rápido para usar la API.