API Usage
Using an API created with PromptJoy can be done in several programming languages. This guide will show you how to use the book search API (https://preview.promptjoy.com/apis/mVMCpq) we created earlier. For this API, we will be making a POST request to
https://api.promptjoy.com/api/mVMCpq
with a JSON payload containing the book search query.The general API request looks like this:
HTTP Method: POST
Headers:
- Content-Type: application/json
- x-api-key: sk-6200906b6fcc732e9265028f53d5d6f01575a162
Data/Payload:
{
"query": "your_search_term"
}
Before diving into language-specific examples, let's talk about how to store your API key as an environment variable. Environment variables are a great way to keep sensitive information like API keys out of your source code. Here's how to do it:
- 1.Windows: Open a new Command Prompt window and type
setx PROMPTJOY_API_KEY "your_api_key"
then press Enter. Replace "your_api_key" with your actual API key. - 2.macOS/Linux: Open a new Terminal window and type
export PROMPTJOY_API_KEY="your_api_key"
then press Enter. Replace "your_api_key" with your actual API key.
You can then access this environment variable in your code using the specific syntax for your programming language. This will be covered in each language-specific example.
Here's how you can make the request using
curl
, a command-line tool used for transferring data with URLs.
curl -X POST https://api.promptjoy.com/api/mVMCpq \
-H 'Content-Type: application/json' \
-H 'x-api-key: '$PROMPTJOY_API_KEY \
-d '{"query":"your_search_term"}'
Replace "your_search_term" with the book you're searching for. The response will be a JSON object containing the search results.
For language-specific examples, please navigate to the sections for Python, JavaScript, Ruby, Go, Java, and C#. Each section will provide a detailed guide on how to use the book search API in the respective language.
Last modified 3mo ago