Custom Connector
FakerAPI.it Connector
Global
FakerAPI.it is a public REST API used to create realistic fake data for development, testing, and connector integration. The connector enables easy retrieval of sample data — people, companies, products, books, images, and text — all via simple HTTP GET requests, with no authentication.
Overview
Integration Overview
This document provides a detailed guide for each integration point, its purpose, parameters, and workflow support using the FakerAPI.it Connector. The connector exposes six core endpoints for generating structured sample data.
- Get Fake Persons. Retrieve randomly generated personal data such as names, emails, and addresses.
- Get Fake Companies. Generate fake company names, industries, and descriptions.
- Get Fake Products. Get mock product data for e-commerce and testing.
- Get Fake Books. Retrieve fake books with author, title, and genre details.
- Get Fake Images. Generate placeholder images for UI and connector testing.
- Get Fake Texts. Produce fake paragraphs or content for text-based testing.
Documentation
Detailed Integration Documentation
Get Fake Persons
| Operation ID | getPersons |
|---|---|
| Endpoint | GET /persons |
| Parameters | Optional: _quantity (integer) — number of persons to generate (e.g. 5). _locale (string) — locale for generated data (e.g. en_US, fr_FR). |
| Purpose | Generates random personal data such as name, email, address, and phone number for testing user-related APIs. |
| Output | JSON array of person objects with identification and contact details. |
| Workflow example | Generate mock user records for testing authentication, registration, or CRM systems. |
Get Fake Companies
| Operation ID | getCompanies |
|---|---|
| Endpoint | GET /companies |
| Parameters | Optional: _quantity (integer) — number of companies to generate (e.g. 3). |
| Purpose | Generates a list of fake company profiles including name, sector, and contact information. |
| Output | JSON array of company objects with structured metadata. |
| Workflow example | Populate fake B2B datasets or simulate organization-based systems. |
Get Fake Products
| Operation ID | getProducts |
|---|---|
| Endpoint | GET /products |
| Parameters | Optional: _quantity (integer) — number of products to generate (e.g. 5). |
| Purpose | Generates fake product data including names, prices, descriptions, and categories. |
| Output | JSON array of product objects suitable for e-commerce or inventory simulations. |
| Workflow example | Test product-listing APIs or populate mock stores in demos. |
Get Fake Books
| Operation ID | getBooks |
|---|---|
| Endpoint | GET /books |
| Parameters | Optional: _quantity (integer) — number of books to generate (e.g. 2). |
| Purpose | Generates fake book data with title, author, and genre. |
| Output | JSON array of book records. |
| Workflow example | Ideal for testing library, publishing, or bookstore management systems. |
Get Fake Images
| Operation ID | getImages |
|---|---|
| Endpoint | GET /images |
| Parameters | Optional: _type (string) — image category (e.g. animals, nature, business). _width (integer) — image width (e.g. 300). _height (integer) — image height (e.g. 300). |
| Purpose | Returns URLs for dynamically generated placeholder images. |
| Output | JSON array of image URLs and metadata. |
| Workflow example | Useful for testing UIs, media placeholders, and front-end rendering pipelines. |
Get Fake Texts
| Operation ID | getTexts |
|---|---|
| Endpoint | GET /texts |
| Parameters | Optional: _quantity (integer) — number of text items to generate (e.g. 1). _characters (integer) — characters per text block (e.g. 100). |
| Purpose | Generates random text blocks for populating paragraphs or content placeholders. |
| Output | JSON array of generated text snippets. |
| Workflow example | Fill mock article data, CMS testing, or text-field validations. |
Example Workflow: Data Simulation for Connectors
| Generate persons | Call /persons?_quantity=5&_locale=en for sample users. |
|---|---|
| Create companies | Use /companies?_quantity=3 to simulate organizations. |
| Add products and books | Retrieve /products or /books for inventory or content testing. |
| Add visual and text data | Integrate /images and /texts to fill UIs or demos with realistic dummy content. |
Support
For technical support, contact custom-connectors-support@isolutions.sa.