<aside> <img src="/icons/warning_lightgray.svg" alt="/icons/warning_lightgray.svg" width="40px" /> This is a beta API. We are still under development, API versioning is not implemented yet and breaking changes might be introduced without prior notice. Please refer to this documentation for updates and maintain compatibility.

</aside>

Introduction

Qogita offers a REST API that provides a streamlined way for your system to integrate with our B2B wholesale trading hub. We connect businesses looking to source Health & Beauty products with a global network of suppliers, offering a vast selection at competitive prices.

Here's what makes our platform unique for buyers:

This API offers a focused set of endpoints categorized by functionality, enabling developers to integrate features like:

This documentation will guide you through getting started, explore common use cases through code snippets, and provide further considerations for successful integration. We also link to our API reference for detailed explanations of each endpoint.

Getting Started

Before diving into the API and some examples, let's ensure you have everything set up for a successful integration.

Prerequisites

URL & Versioning

This API is still under development, versioning is not implemented yet and breaking changes might be introduced without prior notice.

Authentication

The /auth/login/ endpoint is how you get access to our API functionalities. This endpoint uses POST requests and requires an email and password pair in the request body.

<aside> <img src="/icons/info-alternate_lightgray.svg" alt="/icons/info-alternate_lightgray.svg" width="40px" /> The credentials are the same as those you use to log in to www.qogita.com.

</aside>

Successful login responses will include:

Once you’ve successfully authenticated, you simply need to add your Access Token in the Authorization header as Bearer <token> on every API call.

Rate Limiting

To prevent misuse and ensure smooth system performance, some API endpoints have rate limits in place. If you exceed this limit, you'll receive a 429 Too Many Requests HTTP response code.

This response will also include a Retry-After header specifying the number of seconds you should wait before retrying requests to that particular endpoint.

Code Snippets

This section provides practical code examples to help you integrate faster with our API.

These snippets are written in Python and use the popular requests library for making API calls.

Each snippet focuses on a specific task, demonstrating how to interact with the API for common functionalities.

By following these examples and referring to the API reference for detailed endpoint specifications, you can effectively build your integrations and leverage the power of our platform.

If you use Python and want to hit the ground running we can use this recipe script:

qogita-api-recipe-script.zip

Authentication

Searching for Products

Adding Products to Cart

Allocate Cart

Checkout

API Reference

To get all the details about the available endpoints, including all request and response shapes, please visit our API reference documentation.

<aside> <img src="/icons/globe_lightgray.svg" alt="/icons/globe_lightgray.svg" width="40px" /> **https://qogita.readme.io/**

</aside>