Skip to main content

API Endpoint

  • URL: https://text-tad.droplinked.workers.dev/
  • Method: POST
  • Content-Type: application/json

Authentication

An API key is required for access. Contact Droplinked support to obtain your API key. Include it in the request headers as follows:
  • Header: api-key
  • Value: <YOUR_API_KEY> (provided by Droplinked)

Request Format

The API accepts a JSON payload with the following fields:

Request Body

Example Request Body

Response Format

  • Content-Type: text/plain
  • Response: A strict JSON object containing exactly three shop name suggestions, with no additional text or characters.

Response Structure

Example Response

Guidelines for Shop Name Generation

The API generates output based on these rules:
  1. Shop Names:
    • Exactly three unique names reflecting the business concept from the description.
    • Tailored to key themes (e.g., eco-friendliness, blockchain, jewelry in the example).
  2. Output:
    • Strict JSON format with only the "shop_names" key and a three-item array.
    • No extra text, explanations, or additional fields.

JavaScript Example

Below is an example of how to use the Shop Names Generator API in JavaScript with the fetch API:

Error Handling

  • Invalid API Key: Returns an error message (e.g., “Unauthorized”).
  • Missing Fields: If command_name or description is missing, the API may return an error or fail silently.
  • Network Issues: Handle errors in the .catch block of the fetch call.

Example Error Output

Best Practices

  1. Description Detail: Include key aspects of the business (e.g., products, values, technology) for relevant names.
  2. JSON Parsing: Parse the response client-side to access the shop names.
  3. Branding: Use the suggestions as inspiration for official shop naming.
  4. Testing: Experiment with different descriptions to explore naming options.

Support

For assistance or to request an API key, contact Droplinked support at support@droplinked.com. Provide details such as your use case and expected request volume.