O serviço Bíblia de Joda API, fornece uma ação que devolve uma resposta contendo um trecho aleatório da bíblia sagrada. Para acionar a ação faça a seguinte requisição HTTP com o método POST:

https://www.joda.com.br/biblia/rnd_trecho.php

Na entrada da requisição, além das configurações próprias de sua rede, será necessário informar um corpo no formato JSON contento o Token de Login. Veja aqui como obter um Token de Login.

Veja um exemplo de código de requisição no Postman:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
POST /biblia/rnd_trecho.php HTTP/1.1
Host: www.joda.com.br
Content-Type: application/json
Proxy-Authorization: Basic xxxxxxxxxxxxxxxxxxxxxxx=
Authorization: Basic xxxxxxxxxxxxxxxxxxxx
User-Agent: PostmanRuntime/7.18.0
Accept: */*
Cache-Control: no-cache
Postman-Token: d35a1b82-9f05-4c82-a1a4-34912f8b728c,9f080ced-52b2-444e-b02f-75f64740923e
Host: joda-api-php-1.appspot.com
Accept-Encoding: gzip, deflate
Content-Length: 323
Connection: keep-alive
cache-control: no-cache
 
{"jwt": "xxxx...xxxx.xxxx...xxxx.xxxx...xxxx"
}

Se não houver falha, será devolvida uma resposta parecida com o código abaixo:

1
2
3
4
5
6
7
8
9
{
    "livro": "61",
    "capitulo": "2",
    "versiculo": "20",
    "eInicioParagrafo": "0",
    "titulo": "",
    "texto": "Porquanto se, depois de terem escapado das corrupções do mundo, pelo conhecimento do Senhor e Salvador Jesus Cristo, forem outra vez envolvidos nelas e vencidos, tornou-se-lhes o último estado pior do que o primeiro. (...) <FONT SIZE=\"1\" color=gray>(fornecido por Joda.com.br)</FONT>",
    "legenda": "2 Pedro 2:20"
}

O formato do retorno facilita ao desenvolvedor a formatação dos dados para serem exibidos de forma amigável em qualquer plataforma, sistema ou dispositivo, podendo ser em um site, um APP no smartphone ou uma funcionalidade de software em um computador.

Se houver falha na rquisição, será devolvida uma resposta parecida com o código abaixo:

1
{"message":"Acesso negado.","tipo":2}

Acesso Negado

Se você recebeu inesperadamente um retorno do tipo “Acesso negado”, provavelmente está faltando o Token de Login ou o seu nível de identificação não é suficiente para a ação. Este instrumento protege a API de ataques maliciosos. Por isso será necessário se cadastrar na API (faça isso aqui) ou melhorar o seu nível de identificação aqui.

Usuários do WordPress

Se você é usuário do WordPress, veja um exemplo de Widget, utilizando a API, para exibição do trecho em um site desenvolvido em WordPress:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
<?php 
function jda_register_widget() {
	register_widget( 'jda_widget' );
}
 
add_action( 'widgets_init', 'jda_register_widget' );
 
class jda_widget extends WP_Widget {
 
function __construct() {
	parent::__construct(
	// widget ID
	'jda_widget',
	// widget name
	__('Joda Exemplo Widget', ' jda_widget_domain'),
	// widget description
	array( 'description' => __( 'Joda Widget Exemplo', 'jda_widget_domain' ), )
	);
}
public function widget( $args, $instance ) {
	$title = apply_filters( 'widget_title', $instance['title'] );
	echo $args['before_widget'];
	//se titulo está presente
	if ( ! empty( $title ) )
		echo $args['before_title'] . $title . $args['after_title'];
		//saída
		$url = 'https://www.joda.com.br/biblia/rnd_trecho.php';
		$entrada = array(
    		'method'      => 'POST',
    		'timeout'     => 45,
    		'redirection' => 5,
    		'httpversion' => '1.0',
    		'blocking'    => true,
    		'headers'     => array(),
    		'body'        => '{"jwt": "xxxx...xxxx.xxxx...xxxx.xxxx...xxxx"}',
    		'cookies'     => array()
		);
		$response = wp_remote_post( $url, $entrada);
 
		if ( is_wp_error( $response ) ) {
		    $error_message = $response->get_error_message();
    		echo "Algo deu ruim: $error_message";
		} else {
			$myArray = JSON_decode($response['body']);
		    echo '<div>';
			echo '<h3>';
    		print_r($myArray->titulo);
			echo '</h3>';
			echo '<p>';
    		print_r($myArray->texto);
			echo '</p>';
			echo '<p>';
    		print_r($myArray->legenda);
			echo '</p>';
    		echo '</div>';
		}
		echo __( 'Trecho da Bíblia Sagrada', 'jda_widget_domain' );
		echo $args['after_widget'];
	}
	public function form( $instance ) {
	if ( isset( $instance[ 'title' ] ) )
		$title = $instance[ 'title' ];
	else
		$title = __( 'Joda Tecnologia', 'jda_widget_domain' );
		?>
		<p>
			<label for="<?php echo $this->get_field_id( 'title' ); ?>"><?php _e( 'Title:' ); ?></label>
			<input class="widefat" id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" type="text" value="<?php echo esc_attr( $title ); ?>" />
		</p>
	<?php
	}
	public function update( $new_instance, $old_instance ) {
		$instance = array();
		$instance['title'] = ( ! empty( $new_instance['title'] ) ) ? strip_tags( $new_instance['title'] ) : '';
		return $instance;
	}
}?>

O fragmento de código acima, entre as tags “<?php” e “?>” (no início e no final do código) deve ser colocado no arquivo ‘functions.php’ do tema ativo do site.

No corpo da requisição, substitua o valor de “jwt” (mostrado com uma sequência de ‘x’) pelo Token de Login. Veja aqui como obter um Token de Login.

É recomendado que se faça um Backup do seu site antes de fazer as alterações.


Na lateral deste blog (na tela inicial) é possível notar a aplicação prática desta ação da API. A cada atualização da página, será exibido um trecho diferente da Bíblia. O trecho é aleatório e poderá ser composto de um ou mais Versículos da Bíblia.


Este post tem 2 comentários

  1. É possível mostrar um capítulo inteiro da Bíblia?

    1. Sim, Eliana. Você pode usar a API, serviço Bíblia, na tabela Versículo acionando a seguinte URL:
      https://www.joda.com.br/biblia/versiculo/listar.php?livro=xxx&capitulo=yyyy
      onde: xxx é o número que representa o Livro;
      yyy é o número do capítulo desejado.
      No corpo de sua requisição deve conter o valor do livro, o valor do capítulo e o Token de Login.
      { "livro": xxx,
      "capitulo": yyy,
      "jwt": "valor obtido na ação login"
      }

      Você Receberá uma resposta com todos os versículos do capítulo.

Deixe seu comentário

Fechar Menu
×
×

Carrinho