Quickstart

This guide will get you all set up and ready to use Jarside through our API. We'll cover how to get started and how to make your first API request in order to generate Article.

Set up authentication

Before making your first API request, you need to know how our authentication process work.

We use OAuth2 so you need to pass your Bearer API token via the Authorization header like this:

curl https://api.jarside.ai/v1/articles/list \
  -H "Authorization: Bearer {token}"

Generate your first Article

After understanding how to authenticate to our API, you can now generate an article. Below, you can see how to send a POST request to the Article endpoint in order to add an article in the generation queue.

If you need some information, go to generate an article endpoint.

Request

POST
/v1/articles/create
curl --location --request POST 'https://api.jarside.ai/v1/articles/create' \
--header 'Authorization: Bearer {token}' \
--form 'keyword="bmw"' \
--form 'title="L'\''histoire de BMW"' \
--form 'h2_count="4"' \
--form 'openai_model="gpt-4"' \
--form 'language="fr"'

This call will allow you to generate an article about the History of BMW in French which will be approximately 1200 words.

What's next?

Here are a few links that might be handy as you venture further into the Jarside API: