Skip to content

curl.md

Latest commit

 

History

History
246 lines (174 loc) · 4.5 KB

curl.md

File metadata and controls

246 lines (174 loc) · 4.5 KB

Ejemplos con cURL

Consultas Públicas

Health Check

curl https://bible-api.deno.dev/api/checkhealth

Response:

{ "ok": true }

Obtener Todas las Versiones

curl https://bible-api.deno.dev/api/versions

Listar Todos los Libros

curl https://bible-api.deno.dev/api/books

Libros del Antiguo Testamento

curl https://bible-api.deno.dev/api/books/oldTestament

Libros del Nuevo Testamento

curl https://bible-api.deno.dev/api/books/newTestament

Información de un Libro

curl https://bible-api.deno.dev/api/book/genesis

Con abreviación:

curl https://bible-api.deno.dev/api/book/GN

Obtener un Capítulo Completo

curl https://bible-api.deno.dev/api/read/rv1960/genesis/1

Con NVI:

curl https://bible-api.deno.dev/api/read/nvi/apocalipsis/22

Con abreviación de libro:

curl https://bible-api.deno.dev/api/read/rv1960/JN/1

Obtener un Versículo

curl https://bible-api.deno.dev/api/read/rv1960/genesis/1/1

Obtener un Rango de Versículos

curl https://bible-api.deno.dev/api/read/rv1960/genesis/1/1-5

Versículo Aleatorio

curl https://bible-api.deno.dev/api/read/rv1960/verse/random

Versículo aleatorio del Antiguo Testamento:

curl "https://bible-api.deno.dev/api/read/rv1960/verse/random?testament=old"

Versículo aleatorio del Nuevo Testamento:

curl "https://bible-api.deno.dev/api/read/rv1960/verse/random?testament=new"

Búsqueda de Versículos

Buscar "Dios" en RV1960:

curl "https://bible-api.deno.dev/api/read/rv1960/search?q=Dios"

Buscar con paginación y filtro por testamento:

curl "https://bible-api.deno.dev/api/read/nvi/search?q=Dios&testament=old&take=5&page=2"

Buscar "amor" en el Nuevo Testamento, 3 resultados:

curl "https://bible-api.deno.dev/api/read/rv1960/search?q=amor&testament=new&take=3"

Comparar Versículo en Múltiples Versiones

curl https://bible-api.deno.dev/api/verses/across/genesis/1/1

Autenticación

Registro

curl -X POST https://bible-api.deno.dev/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"user":"mi_usuario","password":"contraseña_segura","email":"mi@email.com"}' \
  -c cookies.txt -v

La flag -c cookies.txt guarda las cookies. La flag -v muestra el response headers para ver el Set-Cookie.

Login

curl -X POST https://bible-api.deno.dev/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"mi@email.com","password":"contraseña_segura"}' \
  -c cookies.txt -v

Logout

curl https://bible-api.deno.dev/auth/logout -b cookies.txt -v

Obtener Info del Usuario

curl https://bible-api.deno.dev/user/ -b cookies.txt

Notas (Requieren Auth)

Listar Notas

curl https://bible-api.deno.dev/notes/ -b cookies.txt

Crear Nota

curl -X POST https://bible-api.deno.dev/notes/create \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "title": "Estudio de Génesis 1",
    "description": "Notas sobre la creación",
    "body": "En el principio creó Dios los cielos y la tierra. Este versículo establece...",
    "page": "https://bible-api.deno.dev/api/read/rv1960/genesis/1"
  }'

Obtener Nota por ID

curl https://bible-api.deno.dev/notes/<id-de-la-nota> -b cookies.txt

Editar Nota

curl -X PUT https://bible-api.deno.dev/notes/<id-de-la-nota> \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "title": "Estudio Actualizado",
    "description": "Descripción actualizada",
    "body": "Contenido actualizado del estudio..."
  }'

Eliminar Nota

curl -X DELETE https://bible-api.deno.dev/notes/<id-de-la-nota> -b cookies.txt

Usando Token en Header (sin cookies)

Después de login/signup, extraer el token y usarlo en el header:

# Guardar el token
TOKEN="eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9..."

# Usar en requests
curl https://bible-api.deno.dev/notes/ \
  -H "Authorization: Bearer $TOKEN"

Login y Extraer Token Automáticamente

# Login y capturar token
TOKEN=$(curl -s -X POST https://bible-api.deno.dev/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"mi@email.com","password":"contraseña_segura"}' \
  | jq -r '.token')

# Usar token
curl https://bible-api.deno.dev/notes/ \
  -H "Authorization: Bearer $TOKEN"