Quickstart

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ử 1 cú nhấp mà không cần đăng ký? Bản demo trên trang chủ tại GoGoDuk gọi trực tiếp /v1/demo/suggest (rate-limit theo IP, không cần key).

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.