# การใช้งาน API

## ขั้นตอนการขอใช้งาน

1. ร้องขอ token กับผู้ดูแลระบบฯ เป็นผู้พิจารณา
2. หากท่านได้รับการพิจารณาอนุมัติในการใช้ระบบได้ ทางทีมงานจะส่ง token และ API server url ให้

## วิธีการเรียกข้อมูลผ่าน API
- ส่ง data-form ด้วย POST ไปยัง `http://apiserver/arrest/`
- data-form ประกอบด้วยโครงสร้าง key:value ต่อไปนี้

{ 
'token_key':'your_token_key',
'search':'id หรือ ชื่อ-สกุล'
}

#### ตัวอย่าง curl

curl -X POST http://apiserver/arrest/ -d "token_key=NATIcKeMPlomORecTIlkINGOERNaNtio&search=1234567890123"

#### ตัวอย่าง PHP

$url = 'http://apiserver/arrest/';
$data = array('token_key' => 'NATIcKeMPlomORecTIlkINGOERNaNtio', 'search' => '1234567890123');

$options = array(
    'http' => array(
        'header'  => "Content-type: application/x-www-form-urlencoded\r\n",
        'method'  => 'POST',
        'content' => http_build_query($data)
    )
);
$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);
if ($result === FALSE) { /* Handle error */ }

var_dump($result);

#### ตัวอย่าง Python

import requests

url = 'http://apiserver/arrest/'
myobj = {'token_key':'NATIcKeMPlomORecTIlkINGOERNaNtio', 'search':'1234567890123'}

x = requests.post(url, data = myobj)

print(x.text)

- ระบบจะส่งข้อมูลคืนให้ในรูปแบบ JSON

## Disclaimer
- ตรวจสอบความถูกต้องของข้อมูลทุกครั้ง ก่อนดำเนินการหรือปฏิบัติการ
- การเรียกใช้งานระบบของท่านจะถูกบันทึกไว้เสมอ

 id |            token_key             |  search       |         date_used          
----+----------------------------------+---------------+----------------------------
  1 | NATIcKeMPlomORecTIlkINGOERNaNtio | 1234567890123 | 2019-10-06 08:29:40.615634