El documento explica qué es una API y una API-REST. Una API permite la comunicación entre componentes de software a través de funciones y procedimientos. Una API-REST usa solicitudes HTTP para recuperar, actualizar y eliminar recursos de forma similar a cómo funcionan las páginas web. El documento también describe cómo crear endpoints personalizados en WordPress usando la API-REST para acceder a datos de forma programática.

2. Según la definición de Wikipedia:
“La interfaz de programación de aplicaciones, abreviada como API del inglés:
Application Programming Interface,​ es un conjunto de subrutinas, funciones y
procedimientos (o métodos, en la programación orientada a objetos) que
ofrece cierta biblioteca para ser utilizado por otro software como una capa de
abstracción.
Una API representa la capacidad de comunicación entre componentes de
software.”
¿Qué es una API-Rest?

3. ¿Qué es una API-Rest?

4. Por ejemplo:
https://2018.sevilla.wordcamp.org/wp-json/wp/v2/posts
“A las URLs que reciben o retornan información
de un Web API se les llama endpoints”
¿Qué es un End-Point?

5. Te devuelve todos los tipos de type post que hay en el WordPress que sean
visibles para la API
Get estados
Devuelve los estados de las entradas
Get comentarios
Devuelve los comentarios
/wp-json/wp/v2/types
/wp-json/wp/v2/statuses
Get tipos
/wp-json/wp/v2/comments

6. Devuelve todas las taxonomías hasta de los custom post type
Get categoría
Devuelve las categorías
Get etiquetas
Devuelve las etiquetas
/wp-json/wp/v2/taxonomies
/wp-json/wp/v2/categories
/wp-json/wp/v2/tags
Get taxonomía

7. Get usuario
./wp-json/wp/v2/media
Devuelve los archivos subidos a medios
Get páginas
Devuelve las páginas
./wp-json/wp/v2/pages
Get medios
./wp-json/wp/v2/users/<id_usuario>

8. ./wp-json/wp/v2/posts
Get entrada ./wp-json/wp/v2/post/<id>
Devuelve los 10 últimos artículos de WordPress
*Para poder traer más entradas le añadimos ./wp-json/wp/v2/posts/?per_page=50
Devuelve la entrada con el ID que le hemos indicado
El límite está en 100
Get entradas

9. Get entradas ./wp-json/wp/v2/posts
https://2018.sevilla.wordcamp.org/wp-json/wp/v2/posts

10. ./wp-json/wp/v2/posts
ID del post
https://2018.sevilla.wordcamp.org/wp-json/wp/v2/posts
Get entradas

11. ./wp-json/wp/v2/posts
https://2018.sevilla.wordcamp.org/wp-json/wp/v2/posts
Contenido
Get entradas
URL Entrada

12. ./wp-json/wp/v2/posts
https://2018.sevilla.wordcamp.org/wp-json/wp/v2/posts
ID de usuario autor
Get entradas

13. ./wp-json/wp/v2/users/<id_usuario>
https://2018.sevilla.wordcamp.org/wp-json/wp/v2/users/7425830
Get usuario

14. ./wp-json/wp/v2/users/<id_usuario>
https://2018.sevilla.wordcamp.org/wp-json/wp/v2/users/7425830
Nombre usuario
URL web
Get usuario

15. ./wp-json/wp/v2/users/<id_usuario>
https://2018.sevilla.wordcamp.org/wp-json/wp/v2/users/7425830
URL Avatar
Get usuario

16. En móvil

17. /wp/v2/users/7425830
/wp/v2/posts
Campo date
Campo name
Campo except Campo title
Campo _links > wp:attachment
Post ID
En móvil https://2018.sevilla.wordcamp.org/wp-json
Campo author

18. /wp/v2/posts/3
Campo _links > wp:attachment
Campo content
Campo title
/wp/v2/users/7425830
Campo name
En móvil https://2018.sevilla.wordcamp.org/wp-json
Campo author
Campo date
Campo avatars_URL > 48

19. Rutas especiales donde vamos a poder definir nuestras
propias funciones y ajustar las llamadas a nuestras
necesidades.
Custom endpoint
Crear los custom endpoint en
un plugin. ¡Nunca en el tema!

20. register_rest_route( 'wordapp/v1', '/noticias', array(
'methods' => 'GET',
'callback' => 'listar_noticias',
) );
Registrar una ruta propia:
Método de llamada
Función que se
ejecutará
Custom endpoint
Ruta
/wp-json/wordapp/v1/noticiasURL resultante

21. function listar_noticias(){
$listado_noticias = array();
return $listado_noticias;
}
Función que ejecuta la llamada al endpoint:
Construir un custom endpoint

22. function listar_noticias(){
$listado_noticias = array();
$args = array(
'numberposts' => 10
);
$posts_array = get_posts( $args );
return $listado_noticias;
}
Construir un custom endpoint

23. function listar_noticias(){
...
foreach ($posts_array as $entrada){
array_push($listado_noticias,[
]);
}
return $listado_noticias;
}
Construir un custom endpoint

24. function listar_noticias(){
...
foreach ($posts_array as $entrada){
array_push($listado_noticias,[
‘ID’ => $entrada -> ID,
]);
}
return $listado_noticias;
}
Construir un custom endpoint

25. function listar_noticias(){
...
foreach ($posts_array as $entrada){
array_push($listado_noticias,[
‘ID’ => $entrada -> ID,
'fechaEntrada' => $entrada ->post_date,
'tituloEntrada' => $entrada ->post_title,
'extractoEntrada' => $entrada ->post_excerpt,
‘nombreAutor’ => get_author_name( $entrada -> post_author),
]);
}
return $listado_noticias;
}
Construir un custom endpoint

26. register_rest_route( 'WordAPP/v1', '/noticia/(?P<id>d+)', array(
'methods' => 'GET',
'callback' => 'noticia_por_id',
) );
Con parámetros en la URL
Parámetro
Construir un custom endpoint
/wp-json/wordapp/v1/noticia/<id>URL resultante
Método de
llamada
Función que se
ejecutará
Ruta

27. function noticia_por_id ($data){
$datosNoticia=array();
return $datosNoticia;
}
Construir un custom endpoint

28. function noticia_por_id($data){
$datosNoticia=array();
$noticia=get_post($data[‘id’]);
return $datosNoticia;
}
Construir un custom endpoint

29. function noticia_por_id($data){
...
$datosNoticia=[
'fechaEntrada' => $noticia ->post_date,
‘tituloEntrada' => $noticia ->post_title,
'contenidoEntrada' => $noticia ->post_excerpt,
‘nombreAutor’ => get_author_name( $noticia -> post_author),
‘avatarURL’ => get_avatar_url( $noticia -> post_author ),
];
return $datosNoticia;
}
Construir un custom endpoint

30. Plugin preparado con CE
https://github.com/VictorSTM/PluginAPIWCSevilla
Plugin con los custom endpoints
programados en:

31. https://wplovescarla.com/

32. Paco Marchante Víctor Sáenz
@pacomarchante @victorsaenzTM
¡Gracias!