mirror of
https://github.com/LBRYFoundation/lbry.com.git
synced 2025-08-23 17:47:26 +00:00
35 lines
No EOL
2.2 KiB
PHP
35 lines
No EOL
2.2 KiB
PHP
<h3 id="api">The API</h3>
|
|
<p>
|
|
When running, the LBRY daemon provides a JSON-RPC server running at <code class="code-inline">https://localhost:5279/lbryapi</code>.
|
|
</p>
|
|
<p>
|
|
It can be accessed by any utility capable of making HTTPS GET and POST requests, such as cURL or possibly your toaster.
|
|
</p>
|
|
<p>
|
|
To verify the LBRY daemon is running correctly, let's try looking up a name:
|
|
</p>
|
|
<code class="code-bash"><span class="code-bash__prompt">$</span>curl 'http://localhost:5279/lbryapi' --data '{"method":"resolve_name","params":{"name":"what"}}'
|
|
<span class="code-bash__response">[
|
|
{
|
|
"ver": "0.0.3",
|
|
"description": "What is LBRY? An introduction with Alex Tabarrok",
|
|
"license": "LBRY inc",
|
|
"title": "What is LBRY?",
|
|
"author": "Samuel Bryan",
|
|
"language": "en",
|
|
"sources": {
|
|
"lbry_sd_hash": "d5169241150022f996fa7cd6a9a1c421937276a3275eb912790bd07ba7aec1fac5fd45431d226b8fb402691e79aeb24b"
|
|
},
|
|
"content_type": "video\/mp4",
|
|
"nsfw": false,
|
|
"thumbnail": "https:\/\/s3.amazonaws.com\/files.lbry.io\/logo.png"
|
|
}
|
|
]</span></code>
|
|
<p>Above, we called the method <code class="code-inline"><a href="<?php echo DeveloperActions::API_DOC_URL ?>#resolve_name" class="link-primary">resolve_name</a></code> for the URL <code class="code-inline">lbry://what</code>. This returned the metadata associated with the URL.</p>
|
|
<p>Now let's download it. This time we're going to call the method <code class="code-inline">get</code> with the same parameters.</p>
|
|
<code class="code-bash"><span class="code-bash__prompt">$</span>curl 'http://localhost:5279/lbryapi' --data '{"method":"get","params":{"name":"what"} }'
|
|
<span class="code-bash__response">["d5169241150022f996fa7cd6a9a1c421937276a3275eb912790bd07ba7aec1fac5fd45431d226b8fb402691e79aeb24b"]</span></code>
|
|
<p>The LBRY API consists about 50 calls, all related to discovering, distributing, and purchasing content. <a class="link-primary" href="/api">View the full API documentation</a>.</p>
|
|
<p>You can also list all of the commands available by calling the <span class="code-plan">help</span> command.</p>
|
|
<code class="code-bash"><span class="code-bash__prompt">$</span>curl 'http://localhost:5279/lbryapi' --data '{"method":"help"}'
|
|
</code> |