Aller au contenu
Recherche rapide

Ressources

API et données ouvertes

Les procédures, institutions, corridors, textes, lignes tarifaires, opportunités et indicateurs publiés sur MyEASOKO, en JSON, pour vos applications et vos analyses.

Description OpenAPI 3.1
Adresse de base
https://myeasoko.com/api/v1
Format
JSON (GeoJSON pour les cartes), champs traduits en objets {fr, en}
Limite
60 requêtes par minute sans clé, 600 avec une clé Membre Pro
Cache
ETag sur chaque réponse : renvoyez-le dans If-None-Match pour recevoir 304
CORS
Autorisé depuis tout domaine
Description
https://myeasoko.com/api/v1/openapi.json

Points d'accès

/procedures

GET /api/v1/procedures

Liste des procédures publiées

Paramètres
Paramètres Type Description
flow string : import, export, transit, company, certificate, other Flux : importation, exportation, transit, création d'entreprise...
chapter string Chapitre du système harmonisé (2 chiffres)
institution string Identifiant (slug) de l'institution responsable
q string Texte recherché dans le titre
page integer Numéro de page (à partir de 1)
per_page integer Éléments par page, 25 par défaut, 100 au plus

Exemple

curl -s 'https://myeasoko.com/api/v1/procedures?flow=import&per_page=5'

GET /api/v1/procedures/{slug}

Fiche procédure : étapes, documents, institutions, base légale, sources, version et fraîcheur

Paramètres
Paramètres Type Description
slug (obligatoire) string

Exemple

curl -s 'https://myeasoko.com/api/v1/procedures/{slug}'

/institutions

GET /api/v1/institutions

Annuaire des institutions

Paramètres
Paramètres Type Description
type string Type (ou liste séparée par des virgules) : port, border_post, ministry...
city string
q string
page integer Numéro de page (à partir de 1)
per_page integer Éléments par page, 25 par défaut, 100 au plus

Exemple

curl -s 'https://myeasoko.com/api/v1/institutions?type=port,border_post'

GET /api/v1/institutions/{slug}

Fiche institution avec contacts, services et procédures

Paramètres
Paramètres Type Description
slug (obligatoire) string

Exemple

curl -s 'https://myeasoko.com/api/v1/institutions/{slug}'

/institutions.geojson

GET /api/v1/institutions.geojson

Institutions localisées, au format GeoJSON (points)

Paramètres
Paramètres Type Description
type string

Exemple

curl -s 'https://myeasoko.com/api/v1/institutions.geojson'

/corridors

GET /api/v1/corridors

Corridors de transit : GeoJSON (LineString) avec leurs nœuds

Exemple

curl -s 'https://myeasoko.com/api/v1/corridors'

GET /api/v1/corridors/{slug}

Un corridor (GeoJSON Feature)

Paramètres
Paramètres Type Description
slug (obligatoire) string

Exemple

curl -s 'https://myeasoko.com/api/v1/corridors/{slug}'

/regulatory-texts

GET /api/v1/regulatory-texts

Textes réglementaires : lois, décrets, arrêtés, circulaires

Paramètres
Paramètres Type Description
type string
scope string national, regional (CEDEAO, UEMOA...), international
theme string
in_force boolean 1 pour les textes en vigueur, 0 pour les autres
q string
page integer Numéro de page (à partir de 1)
per_page integer Éléments par page, 25 par défaut, 100 au plus

Exemple

curl -s 'https://myeasoko.com/api/v1/regulatory-texts?in_force=1'

GET /api/v1/regulatory-texts/{slug}

Un texte réglementaire

Paramètres
Paramètres Type Description
slug (obligatoire) string

Exemple

curl -s 'https://myeasoko.com/api/v1/regulatory-texts/{slug}'

/tariff-lines

GET /api/v1/tariff-lines

Lignes tarifaires : recherche par début de code SH ou par texte

Paramètres
Paramètres Type Description
code string Début du code SH, avec ou sans points (1006 ou 1006.30)
q string Texte recherché dans le libellé et les mots clés
chapter string
category integer Catégorie tarifaire (bande de droit de douane)
page integer Numéro de page (à partir de 1)
per_page integer Éléments par page, 25 par défaut, 100 au plus

Exemple

curl -s 'https://myeasoko.com/api/v1/tariff-lines?code=1006'

GET /api/v1/tariff-lines/{code}

Ligne tarifaire avec taux de la bande et prélèvements applicables

Paramètres
Paramètres Type Description
code (obligatoire) string Code SH complet, avec ou sans points

Exemple

curl -s 'https://myeasoko.com/api/v1/tariff-lines/1006300000'

/levies

GET /api/v1/levies

Droits, taxes et prélèvements du régime en vigueur

Paramètres
Paramètres Type Description
flow string : import, export, transit
all boolean 1 pour inclure les lignes inactives ou hors période

Exemple

curl -s 'https://myeasoko.com/api/v1/levies?flow=import'

/simulations

POST /api/v1/simulations

Simulation des droits et taxes (estimation indicative)

Exemple

curl -s -X POST 'https://myeasoko.com/api/v1/simulations' \
  -H 'Content-Type: application/json' \
  -d '{"hs":"1006.30.00.00","value":12000,"currency":"EUR","incoterm":"FOB","freight":900,"insurance":60,"origin":"third","weight_tonnes":25,"containers":1}'

/opportunities

GET /api/v1/opportunities

Opportunités : investissement, appels d'offres, événements

Paramètres
Paramètres Type Description
kind string : investment, tender, event, partner
sector string
open boolean 1 pour les seules opportunités encore ouvertes
page integer Numéro de page (à partir de 1)
per_page integer Éléments par page, 25 par défaut, 100 au plus

Exemple

curl -s 'https://myeasoko.com/api/v1/opportunities?kind=tender&open=1'

GET /api/v1/opportunities/{slug}

Une opportunité

Paramètres
Paramètres Type Description
slug (obligatoire) string

Exemple

curl -s 'https://myeasoko.com/api/v1/opportunities/{slug}'

/indicators

GET /api/v1/indicators

Indicateurs du commerce avec la dernière valeur

Paramètres
Paramètres Type Description
theme string
key boolean 1 pour les indicateurs clés
page integer Numéro de page (à partir de 1)
per_page integer Éléments par page, 25 par défaut, 100 au plus

Exemple

curl -s 'https://myeasoko.com/api/v1/indicators?key=1'

GET /api/v1/indicators/{code}

Un indicateur et sa série d'observations

Paramètres
Paramètres Type Description
code (obligatoire) string
geography string Code géographique (TG par défaut)

Exemple

curl -s 'https://myeasoko.com/api/v1/indicators/{code}'

Clé d'API

L'accès sans clé suffit pour la plupart des usages. Les membres Pro créent une clé dans leur espace membre et l'envoient dans l'en-tête X-Api-Key : la limite passe alors à 600 requêtes par minute. Une clé inconnue ou révoquée reçoit une erreur 401.

curl -s -H 'X-Api-Key: ick_xxxxxxxx.xxxxxxxx' 'https://myeasoko.com/api/v1/'

Erreurs et pagination

Les listes sont paginées (paramètres page et per_page, 100 éléments au plus) et renvoient data, links et meta. Les erreurs renvoient un objet JSON avec message : 404 pour une ressource absente, 422 pour une saisie invalide (détail dans errors), 429 lorsque la limite est atteinte (en-tête Retry-After).

Simulation des droits et taxes

POST /simulations reçoit un objet JSON (hs et value obligatoires) et renvoie le détail ligne par ligne, les totaux et les avertissements. Le résultat est indicatif et n'est pas enregistré.

Conditions de réutilisation

Les données sont réutilisables librement à condition de citer MyEASOKO et la date de consultation. Chaque fiche porte ses sources, son statut de vérification et sa date de validation : reprenez-les avec les données.