Instalación necesidad de comprar una licencia de soporte para la API JSON complemento? La API de eventos Espresso JSON complemento se instala como cualquier otro plugin de WordPress (). Una vez instalado, simplemente configurar los ajustes, a sus necesidades, en el WP Admin> Evento Espresso> API página de configuración de su sitio web WordPress impulsado Evento Espresso. Prueba de la API JSON Para asegurarse de que la API JSON está funcionando correctamente en su sitio web, se agrega esto al final de la URL de su sitio web proporcionado Evento Espresso: Ejemplo /espresso-api/v1/events/public.pretty_json: yoursite.com/espresso -api / v1 / eventos / public.pretty_json ejemplo real de nuestra página web testdrive: Si todo está configurado correctamente, verá algo como esto: JSON API ejemplo de salida de la API del Codex El Evento Espresso JSON API ofrece a los desarrolladores una plataforma completa API para acceder directamente evento de datos y los datos de forma segura y eficaz de los asistentes de fuera de su servidor web. Todo lo que un desarrollador necesita saber acerca es la API URL de punto final para su sitio. Ejemplo: AutenticaciónInformación Privada Para hacer la mayoría de las solicitudes a la API, se tendrá que enviar una clave de sesión con cada solicitud de la URL. Por ejemplo: mysite.com/espresso-api/v1/events/qwer1234 (donde "qwer1234" es la clave de sesión). Para adquirir una clave de sesión, envía un HTTP POST / GET a {wordpress-site} / espresso-api / v1 / autenticarse con GET o POST parámetros: (. Que son nombre de usuario y la contraseña de un usuario de WordPress) "nombre de usuario" y "contraseña" por ejemplo: GET mysite.com/espresso-api/v1/authenticate?username=admin&password=3v3nt (NOTA: el uso de GET en este punto final no se recomienda para la producción, ya que es menos segura que enviando una solicitud POST) mysite.com/espresso la POST -api / v1 / autenticarse con el cuerpo: el usuario: admin contraseña: 3v3nt En caso de éxito, la respuesta se verá así: { "status": "OK", "status_code": 200, "cuerpo": { "session_key": "fwseljoxy5"}} En caso de fallo, la respuesta se verá así: { "status": "Bad nombre de usuario y contraseña combinación.", "status_code": 401} información Pública Evento Espresso administradores del sitio pueden permitir una cierta información seaa disposición del público, lo que no requiere autenticación para acceder a ella. Para activar esta función, debe seleccionar "Permitir API pública de acceso" en la página de configuración de la API de eventos Espresso. Para consultar la información pública, no hay necesidad para autenticar y recuperar una clave de sesión. En su lugar, sólo tiene que utilizar la cadena "público" en lugar de una clave de sesión en todas las solicitudes. Por ejemplo, mysite.com/espresso-api/v1/events/public. Por favor, consulte la sección titulada "Permisos" para obtener información sobre qué información está disponible públicamente cuando esta función está activada. Respuesta / petición formatos (XML, JSON, pretty_json) Esta API es compatible tanto JSON (por defecto) y XML. Para obtener una copia de la respuesta en XML, sólo tiene que añadir ".xml" a cualquiera de la clave de sesión (por ejemplo, "mysite.com/espresso-api/v1/events/{session_key}.xml?id__lt=10" o "mysite. com / espresso-api / v1 / eventos / 14 / {} session_key .xml?). Si desea tener su JSON devuelto de una manera más fácil de leer, pero menos eficiente, formato, sólo tiene que establecer el formato de 'pretty_json' (por ejemplo,"mystei.com/espresso-api/v1/events/{session_key}.pretty_json?id__in=1,23,342~~number=plural) métodos de petición (GET, POST, PUT, DELETE) de acuerdo con los principios REST, el método de solicitud HTTP enviados a un dictados de punto final funcionalidad en este API. Por ejemplo: el envío del método de la petición de borrado en la solicitud será interpretado de manera muy diferente por el servidor de la API que la misma solicitud utilizando el método de la petición PUT. En la siguiente documentación, cada punto final es precedido por el método de solicitud HTTP que invoca esa funcionalidad. (Por ejemplo, el título de "GET / eventos", explica la funcionalidad de enviar una solicitud a "/" eventos utilizando el método de la petición GET). Si no puede enviar PUT o DELETE métodos de petición, hemos proporcionado una solución: en el cuerpo de su solicitud, proporcionar un parámetro llamado 'REQUEST_METHOD' y establezca su valor en el método de la petición deseada. Por ejemplo, si desea enviar una solicitud PUT pero no puede, envía una solicitud POST con REQUEST_METHOD '' los parámetros de la petición: 'PUT' (y el parámetro habitual "cuerpo"con el JSON o XML para indicar lo que quiere actualizar). O si desea enviar una solicitud de BORRAR para / eventos / {id} / {} sessionId, envía la siguiente solicitud GET / eventos / {id} / {} sessionid? REQUEST_METHOD = borrar. Consiguiendo con parámetros de consulta en todas las peticiones GET (por ejemplo, una solicitud GET HTTP a mysite.com/espresso-api/v1/events,) Puede añadir las variables GET cadena de consulta para filtrar los resultados, por ejemplo mysite.com/espresso-api/v1 /events?Datetime.event_start2012-04-23%2000:00:00. Pero, ¿y si desea que todos los eventos antes de abril 23 de 2012? desea utilizar mysite.com/espresso-api/v1/events?Datetime.event_start<2012-04-23%2000:00:00, pero eso es la sintaxis de cadena de consulta HTTP válida. Si desea modificar una consulta como que simplemente anexar '__lt' para el parámetro de cadena de consulta y será interpretado como <(o "menos"). es decir mysitecom / espresso-api / v1 / eventos Datetime.event_start__lt = 2012-04-23% 2000:? 00: 00. Los siguientes operadores están disponibles: MySQL operador de cadena para anexar consulta de ejemplo Parámetro <__lt por ejemplo:mysite.com/espresso-api/v1/events?Datetime.event_start__lt=2012-04-23%2012:23:56 <= __lte por ejemplo: mysite.com/espresso-api/v1/events?Datetime.event_start__lte=2012- 04-23% 2012: 23: 56> __gt por ejemplo: mysite.com/espresso-api/v1/events?Datetime.event_start__gte=2012-04-23%2012:23:56> = __gte por ejemplo: mysite.com/espresso -api / V1 / eventos Datetime.event_start__gt = 2012-04-23% 2012:? 23: 56 COMO __like por ejemplo: mystie.com/esresso-api/v1/attendees?fname__like=%25Tim%25 (tenga en cuenta que "%" urlencoded es% 25) eN __in por ejemplo: mysite.com/espresso-api/v1/registrations__in=234,432,345 es posible que también consulta basada en modelos más afines, siempre y cuando ellos son parte de la respuesta del punto final está consultando currenlty. Por ejemplo, el precio es un modelo relacionado de eventos, y siempre se incluye en cualquier consulta de Eventos. Así que si usted quiere encontrar todos los eventos con un precio de 12,00, se podría hacer una consulta como mysite.com/espresso-api/v1/events/{session_key}?Price.amount=12.00. Otros ejemplos: Ejemplo SQL Descripción de la petición generada por WHEREOBTENER mysite.com/espresso-api/v1/events/{session_key}?name__like=%25party%25&description__like=%25all%20fun%25 Obtener todos los eventos en los que el nombre tiene una subcadena de "parte", y donde la descripción del evento tiene la subcadena 'toda la diversión' DONDE event_name LIKE '%% del partido' Y event_desc LIKE '%% toda la diversión' GET mysite.com/espresso-api/v1/events/{session_key}?/events/{session_key}?Datetime.event_start__lt=2012-02-06%2012:23:56 obtener todos los eventos que se inician antes del 6 de febrero 2012 ¿Dónde Datetime.event_start < '2012-02-06% 2012: 23: 56' GET mysite.com/espresso-api/v1/registrations/{session_key}?Event.id__lt=5 get todos los registros cuyos Event.id asociado es inferior al 5 DONDE wp_events_detail <5 de publicación (crear) con identificadores temporales al publicar información de un recurso para crear una nueva (por ejemplo, la publicación de información de registro en espresso-api / v1 / registros / {sessionId }) el recurso de que pronto se creó a aún no tendrá un ID. Insetad, debe proporcionar una identificación temporal. Identificaciones temporales son cadenas que comienzan con "TEMP" ydespués de cualquier cadena única (por ejemplo, "temp-mi-nueva-registro", "temp-123", "temp-a", etc). ¿Por qué utilizar identificaciones temporales (en lugar de simplemente ignorar el campo ID)? Ids temporales son muy útiles cuando se crean varios recursos relacionados, y por lo tanto le permiten hacer referencia a los recursos pronto-a-ser-creado. Por ejemplo, la creación de 2 registros en una sola transacción nueva. Cada registro tendría su propia identificación temporal único, (por ejemplo, "temp-reg1" Y "temp-reg2" ") y cada uno tendría Set ID de la transacción anidada para un Número de Identificación única de temperatura (por ejemplo," temp-transacción-por-ambos- regs "). Ejemplo de solicitud: { "Registros": [ { "Id": "temp-reg1", "Status": "not_approved", "Date_of_registration": "12/10/2012 16:12:31", "Final_price": 10, "Código": "1-50c67a6f172e1", "URL_LINK": null, "Is_primary": true, "Is_group_registration": true, "Is_going": true, "Is_checked_in": false, "Transacción":{correcta y todos, pero algunos precondición falló antes de que su solicitud de se procesa por completo, lo que quisieras. Ejemplo: si se trató de comprobar un registro en un evento utilizando / registros / 13 / registro, pero no había pagado todavía. Capice? 500 {} Se ha producido varios mensajes algún error interno. Su solicitud estaba bien, pero nuestro software de servidor acaba de morir por alguna razón. Si la respuesta es específicamente "punto final aún no implementado", entonces no acabamos de terminar de trabajar en ese punto final. Espresso molestia de eventos para conseguir que implementa. Ejemplos de código Éstos son algunos ejemplos de código que utiliza la API. Resumen y descripción Enlace código PHP que obtiene todos los eventos próximos y los muestra. Se puede ejecutar desde cualquier dominio. PHP y código HTML que recupera todos los eventos próximos y los muestra en un calendario. Se puede ejecutar desde cualquier dominio. código PHP que obtiene todos los iguala últimos y los muestra. Se puede ejecutar desde cualquier dominio. código PHP que obtiene todos los eventos próximos, las almacena en caché, y los muestra. El uso de almacenamiento en caché puede acelerar
