Passer au contenu principal
Avant de commencer !
Vous devriez creer un compte Blockradar gratuit que vous pouvez utiliser pour tester l’API. Nous vous fournirons des cles de test que vous pouvez utiliser pour effectuer des appels API.

Collection Postman

Voir la Collection Postman
 L’API Blockradar vous donne acces a pratiquement toutes les fonctionnalites que vous pouvez utiliser sur notre tableau de bord et vous permet de les etendre pour une utilisation dans votre application. Elle s’efforce d’etre RESTful et est organisee autour des principales ressources avec lesquelles vous interagirez - avec quelques exceptions notables.

​
Exemples de Requetes

Nous fournissons des exemples d’appels API a cote de chaque methode en utilisant cURL. Tout ce que vous avez a faire est d’inserer vos parametres specifiques, et vous pouvez tester les appels depuis la ligne de commande. Consultez ce tutoriel sur l’utilisation de cURL avec les API. Vous pouvez egalement utiliser Postman si vous n’etes pas familier avec cURL. Postman est une plateforme de developpement et de test d’API facile a utiliser. Vous pouvez explorer la Collection Postman Blockradar pour comprendre comment fonctionnent nos API.

​
Requetes et Reponses

Les donnees du corps de requete et les donnees de reponse sont formatees en JSON. Le type de contenu pour les reponses sera toujours application/json. Generalement, toutes les reponses seront dans le format suivant : 
{
  "statusCode": "[number]",
  "message": "[string]",
  "data": "[object]"
}

​
Cles

ProprieteTypeDescription
statusCodenumberC’est le code de statut de la requete qui vous permet de savoir si votre requete a reussi ou non. Nous recommandons d’utiliser ceci pour determiner le resultat d’un appel API.
messagestringC’est un resume de la reponse et de son statut. Par exemple, lors de la recuperation d’une liste de clients, le message pourrait indiquer “Transactions fetched successfully”. En cas d’erreur, la cle message contiendra une description de l’erreur comme dans la situation d’en-tete d’autorisation ci-dessus. C’est la seule cle universelle a travers les requetes.
dataobjectCela contient les resultats de votre requete. Cela peut etre soit un objet, soit un tableau selon la requete effectuee. Par exemple, une requete pour recuperer une seule transaction retournera un objet transaction dans la cle data, tandis que la cle serait un tableau de transactions si une liste est demandee a la place.

​
Objet Meta

La cle meta est utilisee pour fournir un contexte pour le contenu de la cle data. Par exemple, si une liste de transactions effectuees par un client est recuperee, des parametres de pagination peuvent etre passes pour limiter l’ensemble de resultats. La cle meta contiendra alors un objet avec les attributs suivants : 
{
 "meta": {
    "totalItems": 704,
    "itemCount": 100,
    "itemsPerPage": 100,
    "totalPages": 8,
    "currentPage": 1
  }
}
ProprieteDescription
totalItemsLe nombre total d’elements disponibles. Cela represente le compte complet d’elements sur toutes les pages.
itemCountLe nombre d’elements sur la page actuelle. Cela indique combien d’elements sont retournes dans la reponse actuelle.
itemsPerPageLe nombre maximum d’elements par page. Cela definit la limite de pagination definie pour chaque page. Par defaut : 100
totalPagesLe nombre total de pages disponibles. Cela est calcule en fonction du nombre total d’elements et du nombre d’elements par page.
currentPageLe numero de la page actuelle. Cela indique quelle page de la pagination est retournee dans la reponse actuelle. Par defaut : 1