Version de travail · contenus et exemples à affiner Voir les 95 pages ↗
Parlons de votre projet ↗
Référence API / P074

Lister les demandes de rattachement

Adaptation éditoriale
Référence de travail. Les routes, schémas, limites et procédures hérités du référentiel sont à aligner avec l’API d’Éric. Ils ne prouvent pas une fonctionnalité livrée. Les hôtes .invalid sont des exemples inertes.

Opération

GET /partner_api/service_providers/business_link_requests

Authentification

ApiKey``ApiKeyId

X-API-KEY

Emplacement : header

X-API-KEY-ID

Emplacement : header

Réponses

200 application/json

401 application/json

403 application/json

500 application/json

cURL

JavaScript

Go

Python

Java

C#

Rust

curl -X GET "https://api.kelyko.invalid/partner_api/service_providers/business_link_requests" \
  -H "X-API-KEY: " \
  -H "X-API-KEY-ID: "

200401403500

[\
  {\
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",\
    "status": "pending",\
    "merchantBusinessId": "19d467bb-96e1-48c8-88c3-25dccb98467b",\
    "merchantBusinessName": "string",\
    "serviceProviderBusinessId": "d9fd5ed9-0f9b-4b0c-b030-b83b3b58501a",\
    "serviceProviderBusinessName": "string",\
    "ownerPhone": "string",\
    "expiresAt": "2019-08-24T14:15:22Z",\
    "createdAt": "2019-08-24T14:15:22Z",\
    "serviceProviderMemberId": "9521dd7f-48f7-49ed-bc06-95594b46066b",\
    "redirectUrl": "http://example.com"\
  }\
]

Create API key for merchant business (plateforme API)POST\ \ Creates an API key for a merchant business that the service provider has onboarded. This allows the merchant to access the Partner API.\ **Prerequisites:**\ - The service provider must have onboarded the merchant business (via `/business_onboarding`)\ - The service provider must have permission to create API keys for the merchant\ **Use Cases:**\ - Generate API credentials for merchants after onboarding\ - Allow merchants to integrate with Kelyko's Partner API\ - Manage API access for merchant businesses\ **Important Notes:**\ - The authenticated business must be a service provider\ - The merchant business must exist and be linked to the service provider\ - The API key is returned only once during creation - store it securely\ - The API key is associated with the service provider member that created it\ **Authentication:** Requires API key headers. The authenticated business must be a service provider. Request to link an existing merchant businessPOST\ \ Asks existing Kelyko merchants (matched by owner phone) to authorize linking this\ service provider. Does not create a membership until the merchant approves.\ Each request includes `redirectUrl`, which opens the invite in the Kelyko app.\ **Errors:**\ - 404 `user_not_found` — no Kelyko user with this phone; use `/business_onboarding`\ - 409 `no_owned_business` — user exists but owns no business\ - 409 `already_linked` — already a service provider of that merchant (`extras` is the merchant business id)

Demander à l'IA ⌘I