Données des Opérateurs

Cette page fournit des informations sur les données des opérateurs utilisées dans l'API NoWallet. Ces données permettent d'identifier le code opérateur et la devise correspondante pour les transactions de paiement.

Pour obtenir la liste des opérateurs pris en charge par chaque code pays, vous pouvez utiliser le point de terminaison suivant :

GET{baseUrl}/operators/data

note

Par exemple, si vous souhaitez obtenir des informations spécifiques sur les opérateurs du Cameroun, vous pouvez utiliser l'URL suivante :

{baseUrl}/operators/data?country=CM.

Paramètres de la Requête

Lors de la récupération des données des opérateurs, la requête doit inclure les paramètres suivants dans l'URL :

Name	In	Type	Required	Description
country	query	string	true	Le code pays à vérifier.

Exemples de Code dans Plusieurs Langages

Pour vous aider à intégrer facilement l'API NoWallet, nous fournissons des exemples de code dans divers langages de programmation. Ces exemples montrent comment effectuer une requête au point de terminaison de l'API et gérer la réponse.

• Shell (cURL) : Pour des tests rapides et une utilisation en ligne de commande.
• HTTP : Format brut de la requête HTTP pour comprendre la structure.
• JavaScript : En utilisant fetch pour les environnements de navigateur ou Node.js.
• Ruby : En utilisant la bibliothèque rest-client pour les applications Ruby.
• Python : En utilisant la bibliothèque requests pour les projets Python.
• PHP : En utilisant GuzzleHttp pour les intégrations PHP.
• Java : En utilisant HttpURLConnection pour les applications Java.
• Go : En utilisant le package net/http pour les projets Go.

Exemple de Requête

Voici un exemple de récupération des données des opérateurs en utilisant différents langages. Sélectionnez l'onglet correspondant à votre langage préféré pour voir l'implémentation.

note

Assurez-vous de remplacer {access-token} par votre véritable jeton d'API et de fournir les paramètres requis dans la requête.

cURL

# Exemple de commande cURL pour obtenir les données des opérateurs
curl -X GET {baseUrl}/operators/data?country=string \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

HTTP

GET {baseUrl}/operators/data?country=string HTTP/1.1

Accept: application/json

JavaScript

const headers = {
  Accept: "application/json",
  Authorization: "Bearer {access-token}",
};

fetch("{baseUrl}/operators/data?country=string", {
  method: "GET",

  headers: headers,
})
  .then(function (res) {
    return res.json();
  })
  .then(function (body) {
    console.log(body);
  });

Ruby

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

result = RestClient.get '{baseUrl}/operators/data',
  params: {
  'country' => 'string'
}, headers: headers

p JSON.parse(result)

Python

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('{baseUrl}/operators/data', params={
  'country': 'string'
}, headers = headers)

print(r.json())

PHP

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array();

try {
    $response = $client->request('GET','{baseUrl}/operators/data', array(
        'headers' => $headers,
        'json' => $request_body,
      )
    );
    print_r($response->getBody()->getContents());
}
catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
}

// ...

Java

URL obj = new URL("{baseUrl}/operators/data?country=string");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

Go

package main

import (
      "bytes"
      "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "{baseUrl}/operators/data", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Paramètres de la Réponse

La réponse de l'API inclura les paramètres suivants :

Statut	Signification	Description	Schéma
200	OK	Données des opérateurs récupérées avec succès	En ligne
400	Bad Request	Erreurs possibles dans la requête	Aucun

Types de Réponse

La réponse de l'API inclura les informations suivantes au format JSON :

Réponse de Succès (200 OK)

Exemple de réponse pour une requête réussie

{
  "name": "MTN MONEY",
  "codeoperator": "MTN",
  "logo": "https://www.example.com/assets/img/MTN.png",
  "code": {
    "MERCHANT": "ORANGEMONEYMERCHANTCODE",
    "CASHIN": "ORANGEMONEYCASHINCODE",
    "CASHOUT": "none"
  },
  "startwith": ["01", "02"],
  "otpstarter": {
    "MERCHANT": false,
    "CASHIN": false,
    "CASHOUT": false
  },
  "active": true,
  "secure": {
    "MERCHANT": false,
    "CASHIN": false,
    "CASHOUT": false
  },
  "instruction": {}
}

Réponse d'Erreur (400 Bad Request)

Exemple d'erreur pour une requête incorrecte

{
  "statusCode": 400,
  "error": "COUNTRY_CODE_NOT_FOUND",
  "message": "It seems that this country code does not exist or You can't perform this action, this token does not allow you"
}

Cette page vous a-t-elle été utile ?