BitBook Lite Data API

get_categories

Obtener la lista completa de categorías y subcategorías de libros de la plataforma.

Ejemplo

curl https://bitbooklite.com/api/?type=get_categories&apiUser=00000-AAAAA-00000-AAAAA-00000&apiPassword=000000-AAAAAA-000000-AAAAAA-000000

Endpoint

https://bitbooklite.com/api/

GET parameters

• type (obligatorio - string): Método de la API, en este caso, "get_categories".
• apiUser (obligatorio - string): Usuario de tu credencial de acceso API.
• apiPassword (obligatorio - string): Contraseña de tu credencial de acceso API.

Valores devueltos

JSON

{ "error":false, "errores":[], "answer":[ { "id":"10", "title":{ "esp":"No Ficción Juvenil", "eng":"Youth Non-Fiction" }, "subcategories":[ { "id":"1", "title":{ "esp":"Viajes", "eng":"Travels" } }, { "id":"2", "title":{ "esp":"Tecnología", "eng":"Technology" } } ], } ] }

• error (obligatorio - boolean): "true" en caso de error.
• errores (obligatorio - array): Conjunto de strings con los errores producidos, si existen.
• answer (obligatorio - array): lista de categorías.
  • id (obligatorio - integer): ID de la categoría.
  • title (obligatorio - array): título de la categoría.
    • esp (obligatorio - string): título de la categoría en Español.
    • eng (obligatorio - string): título de la categoría en Inglés.
  • subcategories (obligatorio - array): lista de subcategorías de la categoría.
    • id (obligatorio - integer): ID de la subcategoría.
    • title (obligatorio - array): título de la subcategoría.
      • esp (obligatorio - string): título de la subcategoría en Español.
      • eng (obligatorio - string): título de la subcategoría en Inglés.

get_public_books

Obtener una lista de libros públicos de la plataforma.

Ejemplo

curl https://bitbooklite.com/api/?type=get_public_books&apiUser=00000-AAAAA-00000-AAAAA-00000&apiPassword=000000-AAAAAA-000000-AAAAAA-000000 -d 'limit=10' -d 'orderType=1' -d 'lang=ESP' -d 'search_query=búsqueda'

Endpoint

https://bitbooklite.com/api/

GET parameters

• type (obligatorio - string): Método de la API, en este caso, "get_public_books".
• apiUser (obligatorio - string): Usuario de tu credencial de acceso API.
• apiPassword (obligatorio - string): Contraseña de tu credencial de acceso API.

POST parameters

• limit (opcional - integer): límite de libros a obtener. Máximo: 50.
• limitStart (opcional - integer): inicio del límite de libros a obtener. Sirve para la paginación de los resultados.
• orderType (opcional - integer): orden de los resultados. Valores admitidos: 0 (ascendente, más viejos primero), 1 (descendente, más nuevos primero).
• search_query (opcional - string): cuadro de búsqueda.
• category_id (opcional - integer): ID de la categoría de los libros que se retornarán.
• author_id (opcional - integer): ID del autor de los libros que se retornarán.
• lang (opcional - string): idioma de los libros que se retornarán. Valores admitidos: "ESP" (Español), "ENG" (Inglés).

Valores devueltos

JSON

{ "error":false, "errores":[], "answer":[ { "id":"10", "title":"Título", "subtitle":"Subtítulo", "description":"Esta es una descripción", "keyWords":"palabras, clave", "coverUrl":"https://bitbooklite.com/d/0561651561320651.webp", "author":"Nombre Autor", "priceAmount":"12", "priceCurrency":"USD", "lang":"ESP", "allowedPaymentProcessorsArray":[ "paypal_unique", "litbit" ], "autor_id":"14", "bitbook_id":"AAAA-0000-AAAA-636c403c97ec3", "publishDate":"2022-12-30 21:59:38", } ] }

• error (obligatorio - boolean): "true" en caso de error.
• errores (obligatorio - array): Conjunto de strings con los errores producidos, si existen.
• answer (obligatorio - array): lista de libros.
  • id (obligatorio - integer): ID del libro.
  • title (obligatorio - string): título del libro.
  • subtitle (obligatorio - string): subtítulo del libro.
  • description (obligatorio - string): descripción del libro.
  • keyWords (obligatorio - string): palabras clave del libro.
  • coverUrl (obligatorio - string): URL de la portada del libro.
  • author (obligatorio - string): nombre del autor del libro.
  • priceAmount (obligatorio - float): monto del precio del libro.
  • priceCurrency (obligatorio - string): moneda del precio del libro.
  • lang (obligatorio - string): idioma del libro.
  • allowedPaymentProcessorsArray (obligatorio - array): lista de procesadores de pago habilitados para el libro.
  • autor_id (obligatorio - integer): ID del autor del libro.
  • bitbook_id (obligatorio - string): ID interno del libro.
  • publishDate (obligatorio - date_string): fecha de publicación del libro UTC.
  • link (obligatorio - string): enlace al libro en BitBook Lite.
  • category_id (obligatorio - integer): ID de la categoría del libro.
  • subcategories_ids (obligatorio - array): lista de IDs de las subcategorías del libro.

get_user_public_info

Obtener la información pública de un usuario de la plataforma.

Ejemplo

curl https://bitbooklite.com/api/v2/ -d 'api_consult_type=get_user_public_info' -d 'operation_data={"user_id":"12","id_type":"id"}'

Endpoint

https://bitbooklite.com/api/v2/

GET parameters

n/a

POST parameters

• api_consult_type (obligatorio - string): Método de la API, en este caso, "get_user_public_info".
• operation_data (obligatorio - json encoded array):
  • user_id (obligatorio - string): ID del usuario.
  • id_type (obligatorio - string): Tipo de ID del usuario. Debe ser una de estas opciones: ["id", "id_stringed", "mini_id"].

Valores devueltos

JSON

{ "error":false, "errores":[], "answer":[ { "id":1, "id_stringed":"92944_hJwDc_EkSJg_97547_62ba415c0b3c9", "mini_id":"CB", "name":"Nombre", "surname":"Apellido", "register_date":"2023-05-15 20:00:00", "sex":"man", "verified":false, "profile_picture":"data:image/svg+xml;base64,PHN2ZyB4bWx", "biografy":"Hola, mundo!", "followers_amount":135563, "followers_amount_string":"135.5K", "followeds_amount":1854, "followeds_amount_string":"1.85K", "avatar_id":"03030413010003030712", "user_is_the_avatar_owner":true, "badges":[ [ "pioneer", "" ] ], "user_level_data":{ "actual_level":12, "next_level_points_amount":1000, "points_for_next_level":1000, "points_on_this_level":0 } } ] }

• error (obligatorio - boolean): "true" en caso de error.
• errores (obligatorio - array): Conjunto de strings con los errores producidos, si existen.
• answer (obligatorio - array): información pública del usuario.
  • id (obligatorio - integer): ID del usuario.
  • id_stringed (obligatorio - string): id_stringed del usuario.
  • mini_id (obligatorio - string): mini_id del usuario.
  • name (obligatorio - string): nombre del usuario.
  • surname (obligatorio - string): apellido del usuario.
  • sex (obligatorio - string): sexo/género del usuario. Posibles valores: ["man", "woman", "other"].
  • verified (obligatorio - boolean): true si el usuario está verificado, false si no.
  • profile_picture (obligatorio - string): imágen de perfil del usuario codificada en Base64.
  • biografy (obligatorio - string): biografía del usuario.
  • ...