CLIENTS ET EXEMPLES DE CODAGE

Vous trouverez ici une liste de clients disponibles pour notre API, ainsi que des exemples de codage pour les différentes langues. N’hésitez pas à utiliser tous les exemples fournis pour votre code.

PHP avec Composer

Commencez par installer notre bibliothèque avec Composer :

$ composer require gender-api/client
use GenderApi\Client as GenderApiClient;

try {
    $apiClient = new GenderApiClient('insert your API key');

    // Query a single name
    $lookup = $apiClient->getByFirstName('elisabeth');
    if ($lookup->genderFound()) {
        echo $lookup->getGender();      // female
    }

    // Query a full name and improve the result by providing a country code
    $lookup = $apiClient->getByFirstNameAndLastNameAndCountry('Thomas Johnson', 'US');
    if ($lookup->genderFound()) {
        echo $lookup->getGender();      // male
        echo $lookup->getFirstName();   // Thomas
        echo $lookup->getLastName();    // Johnson
    }

} catch (GenderApi\Exception $e) {
    // Name lookup failed due to a network error or insufficient credits
    // left. See https://gender-api.com/en/api-docs/error-codes
    echo 'Exception: ' . $e->getMessage();
}

Link zur Client-Dokumentation auf Github:

https://github.com/markus-perl/gender-api-client

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client

Commencez par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Commencez par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Téléchargez un exemple de projet ici :

Documentation:

https://github.com/microknights/Gender-API

PHP hérité

Commencez par installer notre bibliothèque avec Composer :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client

function getGender($firstname) {
  $myKey = 'insert your server key here';
  $data = json_decode(file_get_contents(
  'https://gender-api.com/get?key=' .
  $myKey .
  '&name=' . urlencode($firstname)));
  return $data->gender;
  }

  echo getGender('markus'); //Output: male

Commencez par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Commencez par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Téléchargez un exemple de projet ici :

Documentation:

https://github.com/microknights/Gender-API

TypeScript

Commencez par installer notre bibliothèque avec Composer :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client

Commencez par installer notre bibliothèque avec npm :

$ npm i gender-api.com-client --save
import {Client as GenderApiClient, ResultSingleName} from "gender-api.com-client";

const genderApiClient = new GenderApiClient("your API key");

try {
    genderApiClient.getByFirstName('theresa', (response: ResultSingleName) => {
      console.log(response.gender); //female
      console.log(response.accuracy); //98
    });

    genderApiClient.getByFirstNameAndCountry('john', 'US', (response: ResultSingleName) => {
      console.log(response.gender); //male
      console.log(response.accuracy); //99
    });
}
catch(e) {
  console.log('Error:', e);
}

Link zur Client-Dokumentation auf Github:

https://github.com/markus-perl/gender-api-client-npm

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Commencez par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Téléchargez un exemple de projet ici :

Documentation:

https://github.com/microknights/Gender-API

JavaScript

Commencez par installer notre bibliothèque avec Composer :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client

Commencez par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Commencez par installer notre bibliothèque avec npm :

$ npm i gender-api.com-client --save
try {
    var GenderApi = require('gender-api.com-client');

    var genderApiClient = new GenderApi.Client('your api key');

    genderApiClient.getByFirstName('theresa', function (response) {
        console.log(response.gender); //female
        console.log(response.accuracy); //98
    });

    genderApiClient.getByFirstNameAndCountry('john', 'US', function (response) {
        console.log(response.gender); //male
        console.log(response.accuracy); //99
    });

}
catch(e) {
    console.log('Error:', e);
}

Link zur Client-Dokumentation auf Github:

https://github.com/markus-perl/gender-api-client-npm

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Téléchargez un exemple de projet ici :

Documentation:

https://github.com/microknights/Gender-API

Python

Commencez par installer notre bibliothèque avec Composer :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client

Commencez par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Commencez par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Python 3.*
import json

from urllib.request import urlopen

myKey = "insert your server key here"
url = "https://gender-api.com/get?key=" + myKey + "&name=kevin"
response = urlopen(url)
decoded = response.read().decode('utf-8')
data = json.loads(decoded)
print( "Gender: " + data["gender"]); #Gender: male

Python 2.*
import json
import urllib2

myKey = "insert your servery key here"
data = json.load(urllib2.urlopen("https://gender-api.com/get?key=" + myKey + "&name=markus"))
print "Gender: " + data["gender"]; #Gender: male

Téléchargez un exemple de projet ici :

Documentation:

https://github.com/microknights/Gender-API

Java

Commencez par installer notre bibliothèque avec Composer :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client

Commencez par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Commencez par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import com.google.gson.Gson;
import com.google.gson.JsonObject;

public class Main {

  public static void main(String[] args) {

  try {

    String myKey = "insert your server key here";
    URL url = new URL("https://gender-api.com/get?key=" + myKey + "&name=markus");
    HttpURLConnection conn = (HttpURLConnection) url.openConnection();

    if (conn.getResponseCode() != 200) {
      throw new RuntimeException("Error: " + conn.getResponseCode());
    }

    InputStreamReader input = new InputStreamReader(conn.getInputStream());
    BufferedReader reader = new BufferedReader(input);

    Gson gson = new Gson();
    JsonObject json = gson.fromJson(reader, JsonObject.class);
    String gender = json.get("gender").getAsString();
    System.out.println("Gender: " + gender); // Gender: male
    conn.disconnect();

    } catch (IOException e) {
      e.printStackTrace();
    }
  }
}

Téléchargez un exemple de projet ici :

Documentation:

https://github.com/microknights/Gender-API

C#

Commencez par installer notre bibliothèque avec Composer :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client

Commencez par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Commencez par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

https://github.com/markus-perl/gender-api-client-npm

Téléchargez un exemple de projet ici :

Documentation:

https://github.com/microknights/Gender-API
// Contributed Client: https://github.com/microknights/Gender-API

using MicroKnights.Gender_API;
using Microsoft.Extensions.DependencyInjection;
using System;
using System.Net.Http;
using System.Threading.Tasks;

namespace GenderAPI
{
    class Program
    {
        public static async Task RunTests(GenderApiClient client)
        {
            var responseStats = await client.GetStatistics();
            if( responseStats.IsSuccess ) {
                Console.WriteLine($"IsLimitReached: {responseStats.IsLimitReached}");
                Console.WriteLine($"Remaning requests: {responseStats.RemaningRequests}");

                const string Name = "Frank Nielsen";
                var responseName = await client.GetByNameAndCountry2Alpha(Name, "DK");
                if( responseName.IsSuccess ) {
                    Console.WriteLine($"{Name} is {responseName.GenderType.DisplayName}");
                }
                else {
                    Console.WriteLine($"ERRORS: {responseName.ErrorCode}-{responseName.Exception.Message}");
                }
            }
            else {
                Console.WriteLine($"ERRORS: {responseStats.ErrorCode}-{responseStats.Exception.Message}");
            }
        }

        public static Task UsingServiceProvider(string apiKey){
            // client is thread-safe, and can be used static.
            var serviceProvider = new ServiceCollection()
                .UseGenderAPI(apiKey)
                .BuildServiceProvider();

            return RunTests(serviceProvider.GetRequiredService<GenderApiClient>());
        }

        public static Task PlainConsole(string apiKey){
            // client is thread-safe, and can be used static.
            var client = new GenderApiClient(
                new HttpClient
                {
                    BaseAddress = new Uri("https://gender-api.com")
                },
                new GenderApiConfiguration
                {
                    ApiKey = apiKey
                });
            return RunTests(client);
        }

        static async Task Main(string[] args)
        {
            var apiKey = "?";

            await PlainConsole(apiKey);
            await UsingServiceProvider(apiKey);
        }
    }
}

Autres clients et exemples de contributions

Les licences peuvent différer. Les droits d’auteur appartiennent à l’auteur respectif. Vous souhaitez recommander l’ajout d’un client ?

Chat

Cookies

We use cookies (including third-party cookies) to collect information about visitors' use of our website. These cookies help us to provide you with the best possible online experience and to constantly improve our websites. Information collected via cookies may also be processed outside the European Union, for example, in the USA. By clicking the "Accept All" button, you agree to the use of cookies. To withdraw your consent at any time, change your settings or for more information about the use of cookies, click here or "Cookie Settings" at the end of the page.