find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/rekki-connect-customers-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  description: 'The base URL for all API endpoints is https://api.rekki.com/api


    Api key value consists of word Bearer together with api key that you can get from integrations@rekki.com

    '
  title: Rekki.com Supplier catalog Connect Customers API
  contact:
    email: integrations@rekki.com
  license:
    name: All rights reserved
  version: '1.0'
servers:
- url: https://api.rekki.com/api
tags:
- name: connect_customers
paths:
  /integration/v3/customers-and-product-list/connect:
    post:
      security:
      - ApiKeyAuth: []
      description: 'Creates new customers or updates existing ones on your REKKI Connect customer list.


        **NOTE**: **the processing stops at first error**


        ### About product lists

        **IMPORTANT**: Customers'' product lists will be completely replaced by the lists you upload even if they are empty, in which case the product list for the given customer will be emptied.


        If you want to update just the customer data without touching the product list, use `/integration/v3/customers/connect` instead.


        In effect, the product list update behaviour is equivalent to this:

        - Product matching is done via code and unit.

        - New products in the upload will be added to the customer''s product list.

        - Items in the upload that already exist in the customer''s product list will have name and size updated, if there are changes.

        - Items that already exist in the customer''s product list but are not in the upload will be removed.



        ### About contacts

        NOTE: If you add contacts, the name is required as well as at least one of phone

        or email address.


        Status:` 200 OK`

        Body: `{ "status": "success"}`


        Status: `500 `

        Body: `{ "status": "error", "error":"input validation failed: ..."}`

        '
      tags:
      - connect_customers
      summary: Creates or Updates customers and their product lists on REKKI Connect.
      operationId: CreateConnectCustomersAndProductListV3
      parameters:
      - description: Required header
        name: X-REKKI-Authorization-Type
        in: header
        required: true
        schema:
          type: string
          enum:
          - supplier_api_token
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v3.CreateConnectCustomersOutput'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v3.GenericErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: string
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v3.CreateConnectCustomersAndOrderGuideInput'
        description: Payload
        required: true
  /integration/v3/customers/connect:
    post:
      security:
      - ApiKeyAuth: []
      description: 'Create a new customer or update an existing one on your REKKI Connect customer list.


        NOTE: If you add contacts, the name is required as well as at least one of phone

        or email address.


        Status:` 200 OK`

        Body: `{ "status": "success"}`


        Status: `500 `

        Body: `{ "status": "error", "error":"input validation failed: ..."}`


        **the processing stops at first error**

        '
      tags:
      - connect_customers
      summary: Creates or Updates customers on REKKI Connect.
      operationId: CreateConnectCustomersV3
      parameters:
      - description: Required header
        name: X-REKKI-Authorization-Type
        in: header
        required: true
        schema:
          type: string
          enum:
          - supplier_api_token
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v3.CreateConnectCustomersOutput'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v3.GenericErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: string
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v3.CreateConnectCustomersInput'
        description: Payload
        required: true
components:
  schemas:
    v3.ConnectCustomerAndOrderGuideInput:
      type: object
      required:
      - account_number
      - delivery_address
      - name
      properties:
        account_number:
          type: string
        contacts:
          type: array
          items:
            $ref: '#/components/schemas/v3.ConnectCustomerContactInput'
        delivery_address:
          type: string
        delivery_instructions:
          type: string
        name:
          type: string
        order_confirmation_email:
          type: string
        product_list:
          type: array
          items:
            $ref: '#/components/schemas/v3.ConnectCustomerItem'
    v3.CreateConnectCustomersOutput:
      type: object
      properties:
        error:
          type: string
        num_customers_created:
          type: integer
        status:
          type: string
    v3.GenericErrorResponse:
      type: object
      properties:
        error:
          type: string
    v3.ConnectCustomerContactInput:
      type: object
      required:
      - name
      properties:
        email:
          type: string
        name:
          type: string
        phone:
          type: string
    v3.CreateConnectCustomersAndOrderGuideInput:
      type: object
      required:
      - customers
      properties:
        customers:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/v3.ConnectCustomerAndOrderGuideInput'
    v3.ConnectCustomerItem:
      type: object
      properties:
        code:
          type: string
        name:
          type: string
        size:
          type: string
          maxLength: 255
        unit:
          type: string
        spec:
          type: string
    v3.CreateConnectCustomersInput:
      type: object
      required:
      - customers
      properties:
        customers:
          type: array
          items:
            $ref: '#/components/schemas/v3.ConnectCustomerInput'
    v3.ConnectCustomerInput:
      type: object
      required:
      - account_number
      - delivery_address
      - name
      properties:
        account_number:
          type: string
        contacts:
          type: array
          items:
            $ref: '#/components/schemas/v3.ConnectCustomerContactInput'
        delivery_address:
          type: string
        delivery_instructions:
          type: string
        name:
          type: string
        order_confirmation_email:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: Authorization
      in: header