Memodifikasi properti gambar target | PUT /target/<target_id>
Memodifikasi properti gambar target yang sesuai dengan target_id. Modifikasi parameter dalam bentuk Http patch, parameter yang tidak berubah tetap tidak berubah.
Action
PUT /target/<target_id>
Autentikasi
Http header
Content-Type=application/json
HTTP Header: Authorization (saat menggunakan autentikasi API Key Token)
Parameter permintaan
| Field | Type | Diperlukan | Deskripsi |
|---|---|---|---|
| image | String(base64) | Ya | String pengkodean base64 dari konten gambar, mendukung format gambar JPG dan PNG. Ukuran gambar maksimum 2MB. |
| active | String | Tidak | "1" untuk mengaktifkan target, "0" untuk menonaktifkan target. Default "1" |
| name | String | Ya | Nama target, hanya mendukung huruf Inggris, tanda baca Inggris, angka, panjang minimal 1 karakter, maksimal 64 karakter |
| size | String（Float） | Ya | Lebar gambar target (satuan cm). Tinggi gambar target akan dihitung secara otomatis oleh sistem berdasarkan gambar yang Anda unggah. Ukuran gambar target sesuai dengan ukuran konten virtual. Default 20 |
| meta | String | Ya | Biasanya digunakan untuk menyimpan informasi konten AR, format string teks, default "". Contoh: informasi JSON objek yang dikenali, pengkodean base64 gambar, atau URL unduhan file besar di penyimpanan cloud. Maksimum 2MB. |
| type | String (Float) | Ya | Harus dikonfigurasi tetap sebagai string "ImageTarget", perhatikan huruf besar kecil harus sama persis. |
| allowSimilar | String | Tidak | Jika ada gambar serupa apakah diizinkan untuk ditambahkan secara paksa, default 0. Gambar serupa dapat memengaruhi hasil pengenalan, disarankan menggunakan default. |
Catatan
- image dibatasi maksimum 2MB.
- meta dibatasi maksimum 2MB.
Contoh permintaan
PUT /target/e61db301-e80f-4025-b822-9a00eb48d8d2 HTTP/1.1
Host:
Date: Mon, 1 Jan 2018 00:00:00 GMT
Content-Type: application/json
{
"active":"1",
"name":"easyar",
"size":"5",
"meta":"496fbbabc2b38ecs3460a...",
"timestamp": 1514736000000,
"appKey": "test_app_key",
"signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
}
Contoh respons
HTTP/1.1 200 OK
Content-Type: application/json
{
"statusCode": 0,
"result": {
"target": {
"targetId":"e61db301-e80f-4025-b822-9a00eb48d8d2",
"trackingImage":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM..."，
"name": "easyar",
"size": "5",
"meta": "496fbbabc2b38ecs3460a...",
"type": "ImageTarget",
"date": "2016-06-15T09:56:30.000Z",
"active":"1",
"trackableRate": 0,
"detectableRate": 0,
"detectableDistinctiveness"：0,
"detectableFeatureCount": 0,
"trackableDistinctiveness": 0,
"trackableFeatureCount": 0,
"trackableFeatureDistribution": 0,
"trackablePatchContrast": 0,
"trackablePatchAmbiguity": 0
}
},
"timestamp": 1514736000000
}
Field respons
| Field | Deskripsi |
|---|---|
| statusCode | Kode status 0 menunjukkan autentikasi benar, lebih lanjut lihat Kode status |
| result | Pesan kesalahan, atau informasi gambar target |
| timestamp | Waktu server saat respons dikembalikan. Menggunakan format stempel waktu Unix, dalam milidetik |
| result.targetId | ID unik gambar target |
| result.trackingImage | String pengkodean base64 dari gambar pelacakan |
| result.name | Nama target |
| result.size | Lebar gambar target (satuan cm). Tinggi gambar target akan dihitung secara otomatis oleh sistem berdasarkan gambar yang Anda unggah. Ukuran gambar target sesuai dengan ukuran konten virtual yang ditumpangkan |
| result.meta | Informasi tambahan yang dikodekan base64, misalnya string yang dihasilkan dari pengkodean base64 string json |
| result.type | Tetap ImageTarget |
| result.active | "1" aktif, "0" nonaktif |