Paramètres de requête et de réponse communs pour l'API Risk Identification - Fraud Detection

Paramètres de requête communs

Les requêtes adressées aux API Risk Identification incluent des paramètres de requête communs, requis pour toutes les opérations d'API, ainsi que des paramètres d'événement spécifiques au service. Le tableau suivant présente les paramètres de requête communs.

Parameter	Type	Required	Description
Format	String	Yes	Format de la réponse. Valeurs possibles : JSON (par défaut) XML
Version	String	Yes	Version de l'API. La valeur doit respecter le format AAAA-MM-JJ. La version actuelle est 2019-05-21.
AccessKeyId	String	Yes	ID de clé d'accès fourni par Alibaba Cloud pour accéder au service.
Signature	String	Yes	Chaîne de signature. Pour plus d'informations sur le calcul de la signature, reportez-vous à la section 2,0 de Call with an SDK.
SignatureMethod	String	Yes	Méthode de signature. Seul HMAC-SHA1 est pris en charge.
Timestamp	String	Yes	Horodatage de la requête, au format ISO 8601 et en UTC. Format : `yyyy-MM-ddTHH:mm:ssZ`. Par exemple, 09:44:35 le 22 août 2019 (heure de Pékin) correspond à `2019-08-22T01:44:35Z`.
SignatureVersion	String	Yes	Version de l'algorithme de signature. Définissez la valeur sur `1,0`.
SignatureNonce	String	Yes	Nombre aléatoire unique permettant de prévenir les attaques par rejeu. Utilisez une valeur différente pour chaque requête.
Action	String	Yes	La valeur doit être `ExecuteRequestSG` (pour Singapour) ou `ExecuteRequestML` (pour la Malaisie).
Service	String	Yes	Code de service fourni par Alibaba Cloud Security. Ne personnalisez pas cette valeur. Voici les codes de service : Device Fraud Detection : `device_risk_intl` Enhanced Registration Risk Identification : `device_risk_intl_pro` Register Fraud Detection Service : `account_abuse_intl` Social LLM-based Fraud Detection : `account_abuse_intl_pro` Advertise Fraud Detection Service : `coupon_abuse_intl` Enhanced Marketing Risk Identification : `coupon_abuse_intl_pro` Log on to Fraud Detection Service : `email_risk` Device Fraud Detection : `risk_intelligence_ip_intl`
ServiceParameters	String	Yes	Paramètres d'événement spécifiques au service, au format JSON. Exemple : `{"accountId":10123**** ...other request parameters for this event}`. Consultez les rubriques suivantes pour connaître les paramètres de chaque service : Event parameters and technical details of Device Risk Identification Features and parameters of Registration Risk Identification Features and parameters of Marketing Risk Identification Events and response parameters of Email Risk Events and response parameters of IP Risk Intelligence

L'exemple suivant illustre une requête pour le service Device Fraud Detection - Enhanced Edition :

    https://saf.{region}.aliyuncs.com/
    ?Format=JSON
    &Version=2019-05-21
    &Signature=vpEEL0zFHfxXYzSFV0n7%2FZiFL9o%3D 
    &SignatureMethod=Hmac-SHA1
    &SignatureNonce=15215528852396
    &SignatureVersion=1.0
    &Action=ExecuteRequest
    &AccessKeyId=123****saf 
    &Timestamp=2018-06-01T12:00:00Z
    &Service=device_risk_pro
    &ServiceParameters={"deviceToken":1012****}

Paramètres de réponse communs

Chaque requête d'API renvoie un identifiant unique, RequestId, que l'appel aboutisse ou non. D'autres paramètres de réponse, tels que score, tags et extend, varient selon le service. Pour plus d'informations, consultez la documentation du service concerné.

L'exemple suivant présente une réponse JSON pour le service Email Risk :

{
  //service: device_risk_pro
  
 "RequestId": "52E3208D-E7BF-32F0-9913-2A168894D2D9",
 "Message": "OK",
 "Data": {
  		"extend": "0f533f6056f50664b48f2b3866220f0f", // Unique device ID
 		 	"tags": "is_rooted" // Reason code
 },
 "Code": 200 // The request was successful.
}

Remarque

Les exemples de réponses de cette rubrique sont formatés pour faciliter la lecture. Les réponses réelles ne contiennent ni sauts de ligne ni indentation.

Codes d'erreur

Code

Description

200

La requête a abouti.

400

Les ServiceParameters (paramètres d'événement) ne sont pas valides.

402

Le nombre de requêtes par seconde (QPS) dépasse la limite configurée, ce qui déclenche une limitation du débit.

403

Autorisation refusée. Le service n'est peut-être pas activé ou a expiré.

404

Le paramètre Service n'est pas valide.

500

Une erreur interne du serveur s'est produite.