My App
Fournisseurs de services

Lister les activités commerciales (API Fournisseur de services)

Retourne la liste des catégories d'activités commerciales et leurs activités. Ce point de terminaison est équivalent à `/static/activities` mais filtre les catégories et activités désactivées. **Utilisez ce point de terminaison pour :** - Obtenir les catégories d'activités et activités valides pour l'enregistrement des entreprises - Afficher les options d'activité dans votre application - Valider les informations d'activité avant de créer des entreprises **Informations sur les activités :** - Seules les catégories et activités activées sont retournées - Les activités sont regroupées par catégorie - Prend en charge la sélection de langue via l'en-tête `Accept-Language` (par défaut en français) - Les catégories et activités sont triées par ordre alphabétique **Support multilingue :** - Envoyez `Accept-Language: en` pour l'anglais - Envoyez `Accept-Language: fr` pour le français (par défaut) **Authentification :** Nécessite les en-têtes de clé API. L'entreprise authentifiée doit être un fournisseur de services.

GET
/partner_api/service_providers/activities

Retourne la liste des catégories d'activités commerciales et leurs activités. Ce point de terminaison est équivalent à /static/activities mais filtre les catégories et activités désactivées.

Utilisez ce point de terminaison pour :

  • Obtenir les catégories d'activités et activités valides pour l'enregistrement des entreprises
  • Afficher les options d'activité dans votre application
  • Valider les informations d'activité avant de créer des entreprises

Informations sur les activités :

  • Seules les catégories et activités activées sont retournées
  • Les activités sont regroupées par catégorie
  • Prend en charge la sélection de langue via l'en-tête Accept-Language (par défaut en français)
  • Les catégories et activités sont triées par ordre alphabétique

Support multilingue :

  • Envoyez Accept-Language: en pour l'anglais
  • Envoyez Accept-Language: fr pour le français (par défaut)

Authentification : Nécessite les en-têtes de clé API. L'entreprise authentifiée doit être un fournisseur de services.

Authorization

X-API-KEY<token>

Clé API pour les requêtes de l'API Partenaire

In: header

Header Parameters

Accept-Language?string

Code de langue pour les noms d'activités (fr ou en). Par défaut fr si non fourni.

Default"fr"
Value in"fr" | "en"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/partner_api/service_providers/activities"
[
  {
    "id": "retail",
    "name": "Vente de détails",
    "activities": [
      {
        "id": "home_appliances",
        "name": "Electromenager"
      },
      {
        "id": "clothing",
        "name": "Vêtements"
      }
    ]
  }
]
{
  "id": "unauthorized",
  "message": "Unauthorized",
  "extras": "Détails supplémentaires de l'erreur"
}
{
  "id": "business_not_service_provider",
  "message": "L'entreprise n'est pas un fournisseur de services",
  "extras": "L'entreprise authentifiée doit être un fournisseur de services pour accéder à ce point de terminaison"
}
{
  "id": "internal_error",
  "message": "Une erreur inattendue s'est produite",
  "extras": "Détails supplémentaires de l'erreur"
}

Intégrer une nouvelle entreprise (API Fournisseur de services) POST

Intègre une nouvelle entreprise marchande au nom d'un fournisseur de services. Ce point de terminaison crée un nouvel utilisateur, une nouvelle entreprise et établit la relation de fournisseur de services. **Cas d'usage :** - Les fournisseurs de services (comme Payme) peuvent intégrer des marchands via leur propre plateforme - Automatise le processus d'enregistrement des entreprises - Établit automatiquement la relation de fournisseur de services **Ce que fait ce point de terminaison :** 1. Crée un nouveau compte utilisateur (si le numéro de téléphone n'existe pas) 2. Crée une nouvelle entreprise avec les informations fournies 3. Configure la configuration de l'entreprise (active l'accès API) 4. Crée un membre d'entreprise de fournisseur de services liant le fournisseur de services au marchand 5. Définit le code de parrainage si fourni **Notes importantes :** - L'entreprise authentifiée doit être un fournisseur de services (vérifié via middleware) - Le numéro de téléphone doit être unique - si un utilisateur avec ce téléphone existe déjà, une erreur est retournée - L'entreprise de fournisseur de services est automatiquement liée à l'entreprise marchande - L'accès API est automatiquement activé pour la nouvelle entreprise marchande **Authentification :** Nécessite les en-têtes de clé API. L'entreprise authentifiée doit être un fournisseur de services.

Lister les villes et municipalités (API Fournisseur de services) GET

Retourne la liste des villes et leurs municipalités. Ce point de terminaison est équivalent à `/static/locations` mais filtre les localisations désactivées. **Utilisez ce point de terminaison pour :** - Obtenir les codes de ville et municipalité valides pour l'enregistrement des entreprises - Afficher les options de localisation dans votre application - Valider les informations de localisation avant de créer des entreprises **Informations sur les localisations :** - Seules les villes et municipalités activées sont retournées - Chaque ville contient une liste de ses municipalités - Les localisations sont triées par ordre alphabétique **Authentification :** Nécessite les en-têtes de clé API. L'entreprise authentifiée doit être un fournisseur de services.