# Xác thực / môi trường

## Testing

{% hint style="info" %}
Dữ liệu trong môi trường này sẽ không được lưu trữ lâu dài, phục vụ mục đích thử nghiệm.
{% endhint %}

```
REQUEST / HTTP/1.1
Host: testing-api.ghsv.vn
Content-Type: application/json
Token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoiMTQiLCJicmFuY2giOiJkZW1vLmdoc3Yudm4iLCJzZXNzaW9uIjoxNjUyNDY0MTU4fQ.zBeoadjqMWsJj26VeWoV9vrtPKOhDNriZaAm_IqpQGM
```

## Production

### Khởi tạo Token

{% hint style="info" %}
Token dùng để xác định tài khoản thực hiện các yêu cầu qua API từ đó đồng bộ với hệ thống GHSV. 
{% endhint %}

![](https://105699430-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkC73w3lJcipRdQVIPEcV%2Fuploads%2FCCHmLTcQp3OOZ0pPV9pl%2FScreen%20Shot%202022-05-14%20at%2014.07.51.png?alt=media\&token=709edeab-62bf-4b20-8ee7-25695418c1c9)

```
REQUEST / HTTP/1.1
Host: api.ghsv.vn
Content-Type: application/json
Token: token-cua-ban
```

## Cấu trúc Response chung

* Token không hợp lệ

```json
// Content-Type: application/json
// 403: Unauthorized
{
    "success": false,
    "msg": "Token không hợp lệ."
}
```

* Thao tác thành công

```json
// Content-Type: application/json
// 200: OK
{
    "success": true,
    "msg": ""
    // thông tin khác
}
```

* Thao tác thất bại

```json
// Content-Type: application/json
// 200: OK
{
    "success": false,
    "msg": "nguyên nhân / lý do."
}
```