Rating tingkat kesulitan recognizability gambar | POST /grade/detection

Memberi skor tingkat kesulitan recognition gambar dari 0 hingga 4 secara berurutan. Semakin besar skor, semakin besar tingkat kesulitannya. -1 menunjukkan error recognition karena gambar tidak memenuhi requirement, seperti gambar rusak atau kertas putih kosong.

Best practice adalah memanggil API ini sebelum membuat target image baru.

Grade	Deskripsi
0 atau 1	Target mudah dideteksi
2	Sedang
3 atau 4	Target sulit dideteksi

Action

Terdapat tiga API. Secara umum, jika hanya melakukan image search by image, Anda hanya memerlukan rating komprehensif dari sisi recognizability.

• POST /grade/detection

  • Hanya memberikan hasil komprehensif dari sisi recognizability

• POST /grade/tracking

  • Hanya memberikan hasil komprehensif dari sisi trackability

• POST /grade/detail

  • Memberikan rating algoritme detail multidimensi

Authentication

Diperlukan

Http Header

Content-Type=application/json

HTTP Header: Authorization (saat menggunakan authentication API Key Token)

Parameter request

Field	Type	Required	Description
image	String(base64)	Yes	String base64 encoded dari konten gambar. Mendukung gambar JPG dan PNG. Ukuran maksimum gambar 2MB.

Field return

Field	Deskripsi
statusCode	Status code 0 menunjukkan authentication benar. Untuk selengkapnya, lihat Status code
result	Pesan error, atau grade
timestamp	Waktu server saat response dikembalikan. Menggunakan format Unix timestamp, dalam milidetik
result.grade	[-1, 0, 1, 2, 3, 4], dengan 0 dan 1 berarti mudah dikenali. 4 paling sulit dikenali. -1 berarti gambar tidak memenuhi requirement.

Error code

Lihat Status code dan error code

Contoh request

    POST /grade/detection/ HTTP/1.1
    Host:
    Date: Mon, 1 Jan 2018 00:00:00 GMT
    Content-Type: application/json
    {
        "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
        "timestamp": 1514736000000,
        "appKey": "test_app_key",
        "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
    }

Contoh return

    HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "statusCode": 0,
        "result": {
            "grade": 1
        },
        "timestamp": 1514736000000
    }