Quickstart

Thực hiện lần gọi API đầu tiên của bạn trong chưa đầy một phút.

1. Lấy API key

Đăng nhập vào dashboard và nhấn Create API key. Chọn một môi trường (LIVE cho production, SANDBOX để testing) và sao chép key trả về — nó chỉ được hiển thị một lần duy nhất.

Key trông giống như gdk_live_xxxxxxxxxxxxxxxxxxxxxxxx.

2. Thực hiện một request

Dùng key trong request header X-API-Key.

curl "https://api.gogoduk.com/v1/suggest?input=ho+chi+minh" \
  -H "X-API-Key: gdk_live_xxxxxxxxxxxxxxxxxxxxxxxx"

const res = await fetch(
  "https://api.gogoduk.com/v1/suggest?input=ho+chi+minh",
  { headers: { "X-API-Key": process.env.GOGODUK_KEY! } }
);
const { predictions } = await res.json();

import os, requests
 
r = requests.get(
    "https://api.gogoduk.com/v1/suggest",
    params={"input": "ho chi minh"},
    headers={"X-API-Key": os.environ["GOGODUK_KEY"]},
)
print(r.json())

3. Kiểm tra response

Mọi response đều là JSON. Các lần gọi thành công cũng trả về các rate-limit header:

X-RateLimit-Limit-Minute: 60
X-RateLimit-Remaining-Minute: 59
X-RateLimit-Limit-Day: 1000
X-RateLimit-Remaining-Day: 999
X-Request-ID: 8f0e1c54-...

Cần dùng thử nhanh? Trải nghiệm ngay bản demo tương tác trực tiếp trên trang chủ GoGoDuk.

Tiếp theo là gì

Tra cứu chi tiết đầy đủ của một địa điểm với /v1/place/resolve.
Tra ngược tọa độ với /v1/reverse.
Đọc hướng dẫn xác thực về các môi trường, xoay vòng (rotation) và thu hồi (revocation) key.

Quickstart

1. Lấy API key

2. Thực hiện một request

3. Kiểm tra response

Tiếp theo là gì

On this page