Sample upload API reference

1. Before you begin

Create a Resource Access Management (RAM) user for your Alibaba Cloud account and use its AccessKey ID and AccessKey secret to call the API. This practice simplifies future management.

1. Log on to the RAM console.

2. Identity Management > Users > Create User

3. Click the username and create an AccessKey ID.

4. Add permissions. Search for AliyunYundunSAFFullAccess and add it to the user.

2. Integrate using a server-side SDK

Use the Alibaba Cloud Fraud Detection software development kit (SDK) to call the Fraud Detection service. The SDK handles complex tasks such as signature validation and body format construction. SDKs are available for Java, Python, PHP, C#, Go, Node.js, and Ruby.

Java Maven dependency:

<dependencies>
    <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>safconsole20210112</artifactId>
        <version>1.0.1</version>
    </dependency>
</dependencies>

Code example:

public class ApiTest {
    public static void main(String[] a) throws Exception {
        /**
         * An AccessKey for an Alibaba Cloud account has full permissions for all APIs. Use a RAM user for API access or daily O&M.
         * Do not hard-code your AccessKey ID and AccessKey secret into your project code. Hard-coding your credentials can lead to security risks.
         * This example reads the AccessKey of a RAM user from environment variables to authenticate API access. Before you run this code, configure the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables.
         */

        // The AccessKey ID of the RAM user.
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        // The AccessKey secret of the RAM user.
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");

        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
                // Required. Your AccessKey ID.
                .setAccessKeyId(accessKeyId)
                // Required. Your AccessKey secret.
                .setAccessKeySecret(accessKeySecret);
        config.endpoint = "safconsole.cn-shanghai.aliyuncs.com";
        com.aliyun.safconsole20210112.Client client = new Client(config);

        // Generate the access code. For information about the fields, see the parameter descriptions.
        String dataType = "ip";
        String dataValue = "[\"123.xxx.xxx.xxx\",\"123.xxx.xxx.xxx\"]";
        String sampleType = "block";
        String service = "account_abuse,coupon_abuse,account_takeover";
        UploadSampleApiRequest request = new UploadSampleApiRequest();
        request.setDataType(dataType);
        request.setDataValue(dataValue);
        request.setSampleType(sampleType);
        request.setService(service);

        UploadSampleApiResponse response = client.uploadSampleApi(request);
        System.out.println("httpResponse:" + JSONObject.toJSONString(response));

        // If the access fails, check the connection to the POP gateway.
        if (response.statusCode != 200) {
            // Error handling.
            System.out.println("Gateway error");
            return;
        }

        // Backend request error. Handle the error as described in the API reference.
        if (!"200".equals(response.body.code) || !"true".equals(response.body.success)) {
            System.out.println("Backend request error. Handle the error as described in the API reference.");
            System.out.println(response.body.message);
            return;
        }

        // Request successful.
        System.out.println("Request successful");
        return;

    }
}