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/mVMCpqwith a JSON payload containing the book search query.
The general API request looks like this:
HTTP Method: POST
- Content-Type: application/json
- x-api-key: sk-6200906b6fcc732e9265028f53d5d6f01575a162
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 \
Replace "your_search_term" with the book you're searching for. The response will be a JSON object containing the search results.