# API | HTTP

## **Pendahuluan** <a href="#api-introduction" id="api-introduction"></a>

Antares menggunakan approach RESTful dalam mengembangkan API sehingga API yang disediakan lebih representatif dan mudah digunakan user. Sebuah API terdiri atas URL dan parameter.

### **URL**

URL merupakan kependekan dari Uniform Resource Locator. URL dalam bahasa sederhana adalah link. URL tersusun dari domain dan diikuti port. Dalam banyak kasus, https tidak terlihat portnya, ketika server tersebut menggunakan port default (443). Oleh karena itu, server yang tidak menggunakan port default, harus dicantumkan portnya, contoh

```http
https://platform.antares.id:8443
```

Penjelasan lebih detail terkait RESTful API bisa didapatkan di <https://www.restapitutorial.com/>

### **Parameter**

Parameter digunakan ketika ingin menginputkan sesuatu melalui API. Parameter bisa terdapat di Headers, Path, dan Query String Parameter.

### **Header Parameter**

<table><thead><tr><th width="209"></th><th></th></tr></thead><tbody><tr><td>X-M2m-Origin</td><td><mark style="color:red;"><code>{{access-key}}</code></mark></td></tr><tr><td>Content-Type</td><td><mark style="color:red;"><code>application/json;ty=3</code></mark></td></tr><tr><td>Accept</td><td><mark style="color:red;"><code>application/json</code></mark></td></tr></tbody></table>

### **Path Parameter**

```http
https://platform.antares.id:8443/~/antares-cse/antares-id/{{your-application-name}}
```

### **Query String Parameter**

Query string parameters digunakan dengan simbol tanda tanya (?) di URLnya. Setelah tanda tanya (?) adalah parameter dan nilainya yang dihubungkan dengan simbol sama dengan (=). Setiap query string parameter dipisahkan dengan simbol (&).

```http
https://platform.antares.id:8443/~/antares-cse/antares-id/{{your-application-name}}?fu=1&ty=3&lim=5
```

Penjelasan lebih detail terkait parameters silahkan dapatkan di <https://idratherbewriting.com/learnapidoc/docapis_doc_parameters.html>

## List Query String Parameter

<table><thead><tr><th width="188"></th><th width="122.33333333333331"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Value</strong></td><td><strong>Keterangan</strong></td></tr><tr><td>fu</td><td>0</td><td>Non-aktifkan Filter</td></tr><tr><td></td><td>1</td><td>Aktfikan Filter</td></tr><tr><td>lim</td><td>n</td><td>Jumlah Respon yang dihararapkan</td></tr></tbody></table>

{% content-ref url="api-or-http/device" %}
[device](https://docs.antares.id/api-or-http/device)
{% endcontent-ref %}

{% content-ref url="api-or-http/data-of-device" %}
[data-of-device](https://docs.antares.id/api-or-http/data-of-device)
{% endcontent-ref %}

{% content-ref url="api-or-http/subscriber" %}
[subscriber](https://docs.antares.id/api-or-http/subscriber)
{% endcontent-ref %}