Platzi User API
Los datos del usuario son consumidos por primera vez desde platzi.com (la extracción de datos puede tardar unos segundos), luego son guardados en una base de datos para que las próximas peticiones se consuman desde ahí. Dichos datos son actualizados si han pasado 24 horas desde la última actualización, en la próxima petición del usuario.
Live example en mi página web
Información del servidor
- Límite de 200 peticiones por minuto
- Caché de 10 minutos
getUserSummary - Obtener datos de usuario
Ejemplo de uso
curl -i
https://platzi-user-api.jecsham.com/api/v1/getUserSummary/@jecsham
Respuesta
Valores obtenidos de status
| Key | Descripción del valor |
|---|---|
| error | Indica si huvo error en la petición |
| code | Código de estado. Ver referencia |
Valores obtenidos de userData
| Key | Descripción |
|---|---|
| socials |
Redes sociales del usuario.
type es la red
social,
id
es el identificador único del
usuario en la red social
|
| careers |
Carreras aprovadas del usuario.
id es el
identificador único de la
carrera, title es
el nombre de la carrera,
logo es la URL del
logo de la carrera,
golden_achievement
es la URL del icono gold de la
carrera,
diploma_link es la
URL del diploma,
active indica si la
carrera está activa
|
| courses |
Cursos aprovados del usuario.
id es el
identificador único del curso,
title es el nombre
del curso, badge es
la URL del logo del curso,
url es la URL del
curso,
career
es el nombre de la carrera
principal a la que pertenece el
curso,
diploma_link
es la URL del diploma
|
| inactive_courses |
Cursos inactivos/obsoletos
aprovados del usuario.
id es el
identificador único del curso,
title es el nombre
del curso, badge es
la URL del logo del curso,
url es la URL del
curso,
career
es el nombre de la carrera
principal a la que pertenece el
curso,
diploma_link
es la URL del diploma
|
| contributions |
Aportes del usuario.
ides el
identificador único del aporte,
title es el nombre
del aporte,
created_at es la
fecha de creación del aporte,
n_stars es el total
de votos del aporte,
n_responses es el
total de comentarios del aporte,
detail_url es la
URL del aporte,
course_name es el
curso donde fue publicado el
aporte
|
| username | Nombre de usuario |
| avatar | URL del avatar del usuario |
| flag | URL de la bandera del usuario |
| last_update | Fecha de la última actualización de datos de ese perfil en nuestra base de datos |
| name | Nombre del usuario |
| platzi_rank | Puntos de Platzi del usuario |
| profile_url | URL del perfil de Platzi del usuario |
| website | URL de la página web del usuario |
Códigos de estado
| Código | Error | Descripción |
|---|---|---|
| 200 | false | Petición exitosa |
| 403 | true | Perfil privado |
| 404 | true | Usuario no encontrado |
| 429 | true | Límite de solicitudes excedido (max. 200 por minuto) |
| 500 | true | Error interno del servidor |
¿Problemas?
Tweet me 📢