Clase del status
Devolvé "exito" (2xx), "redireccion" (3xx), "cliente" (4xx) o "servidor" (5xx). Ejemplo: clase_status(404) → "cliente"
Entrá y llevá tu progreso —ejercicios, medallas y Pokémon— a cualquier dispositivo. 🔄
Si tu cuenta ya tiene progreso guardado, se carga ese al entrar.
Entraste como . Tu progreso se sincroniza solo. 🔄
Devolvé "exito" (2xx), "redireccion" (3xx), "cliente" (4xx) o "servidor" (5xx). Ejemplo: clase_status(404) → "cliente"
🎯 Meta: entrar a Hoenn, la región de las APIs. Vas a aprender qué es una API, cómo hablan los programas por internet (HTTP) y en qué idioma (JSON).
Bienvenido a Hoenn. 🛰️ Acá aprendés a construir APIs: la forma en que los programas se piden datos entre sí. La Pokédex de tu celular le pide datos a un servidor; ese servidor tiene una API.
Vos (el cliente) vas al mostrador y pedís algo (“curá mis Pokémon”). La enfermera Joy (el servidor) lo hace y te responde. No entrás a la cocina: pedís por el mostrador, con reglas claras. Eso es una API: un mostrador de datos.
| Concepto | Qué es |
|---|---|
| Cliente | quien pide (tu app, el navegador) |
| Servidor | quien responde (la API) |
| Request | el pedido |
| Response | la respuesta |
Cada pedido usa un método y recibe un código de estado:
| Método | Para qué |
|---|---|
| GET | pedir/leer datos |
| POST | enviar/crear datos |
| PUT | actualizar |
| DELETE | borrar |
| Código | Significa |
|---|---|
| 200 | OK ✅ |
| 201 | creado |
| 404 | no encontrado |
| 500 | error del servidor |
P: Cuando tu app hace un pedido HTTP para **leer** datos de una API, ¿qué método usás?
- POST
- DELETE
+ GET
> `GET` es para leer/pedir datos. `POST` crea, `PUT` actualiza, `DELETE` borra. Pedir la info de un Pokémon es un `GET`.
Las APIs mandan datos en JSON: texto con la misma pinta que un diccionario de Python.
import json
# de Python a JSON (texto)
pokemon = {"nombre": "Pikachu", "nivel": 25}
texto = json.dumps(pokemon)
print(texto) # '{"nombre": "Pikachu", "nivel": 25}'
print(type(texto)) # <class 'str'>
# de JSON (texto) a Python
de_vuelta = json.loads(texto)
print(de_vuelta["nombre"]) # Pikachu
💡 json.dumps = dump string (Python → texto JSON). json.loads = load string (texto JSON → Python). El JSON viaja como texto por la red.
P: ¿Qué hace `json.loads('{"nombre": "Pikachu"}')`?
- Convierte un diccionario de Python a texto JSON.
- Guarda el JSON en un archivo.
+ Convierte el texto JSON a un diccionario de Python.
> `loads` = **load string**: recibe texto JSON y devuelve Python. Al revés, `dumps` convierte de Python a texto JSON.
Cuando una API te responde, recibís JSON y lo convertís a Python para usarlo.
import json
respuesta = '{"results": [{"name": "bulbasaur"}, {"name": "ivysaur"}]}'
datos = json.loads(respuesta)
print("cantidad:", len(datos["results"]))
print("primero:", datos["results"][0]["name"])
| Cosa | Para qué |
|---|---|
| API | mostrador de datos (cliente ↔ servidor) |
| HTTP | el protocolo: métodos (GET/POST/…) y códigos (200/404…) |
json.dumps(obj) | Python → texto JSON |
json.loads(texto) | texto JSON → Python |
Practicá con los ejercicios de este tema. 💪
⚡ “Toda app que conocés le habla a una API. Ahora vas a construir la tuya.”