Bỏ qua, tới nội dung chính
NƯỚC NAM
Đăng nhập

Tài liệu API

REST /api/v1, JSON, dùng chung cho web và ứng dụng điện thoại. Bản OpenAPI 3.1: /api/v1/openapi.json. Xác thực bằng cookie phiên hoặc Authorization: Bearer <token>. Giới hạn 300 yêu cầu/phút/IP.

Tài khoản

GET/api/v1/mecần đăng nhập

Người dùng hiện tại

GET/api/v1/me/exportcần đăng nhập

Tải toàn bộ dữ liệu của tôi (JSON)

GET/api/v1/notificationscần đăng nhập

Thông báo của tôi

POST/api/v1/pushcần đăng nhập

Đăng ký thông báo đẩy (Web Push)

Địa lý

GET/api/v1/geo/countries

Danh sách quốc gia

  • launched — 1 = chỉ nước đã mở
GET/api/v1/geo/cities

Thành phố của một nước (kèm khu vực khi đã mở)

  • country (bắt buộc) — Mã ISO 3166-1, vd JP
  • areas — 1 = kèm danh sách quận/khu

Danh mục

GET/api/v1/categories

Cây danh mục 2 cấp

Tìm kiếm

GET/api/v1/search

Tìm doanh nghiệp/dịch vụ

  • q — Từ khóa (có dấu/không dấu, tiếng Anh/Nhật)
  • o — Nơi chốn: tên thành phố/khu vực hoặc 'gan-toi'
  • lat — Vĩ độ (khi tìm gần tôi)
  • lng — Kinh độ
  • cat — Slug danh mục
  • open — 1 = đang mở cửa
  • vn — owned | speaking
  • verified — 1 = đã xác minh
  • sort — relevance | distance | rating | newest
  • page — Trang (từ 1)
GET/api/v1/suggest

Gợi ý tự động (danh mục, doanh nghiệp, thành phố, khu vực, ga tàu)

  • q (bắt buộc) — Chuỗi đang gõ

Bản đồ

GET/api/v1/pins

Ghim trong khung bản đồ

  • bbox (bắt buộc) — west,south,east,north
  • layers — business,event,job,housing,market,group
  • cat — Nhóm/danh mục
  • country — Chỉ ghim trong nước này
  • city — Chỉ ghim trong thành phố này (id)
GET/api/v1/geocodecần đăng nhập

Gợi ý địa chỉ / đọc ngược tọa độ

  • q — Địa chỉ
  • lat — Vĩ độ (đọc ngược)
  • lng — Kinh độ
  • country — Giới hạn trong nước

Doanh nghiệp

GET/api/v1/businesses/{slug}

Chi tiết doanh nghiệp công khai

  • slug (bắt buộc) — Slug
POST/api/v1/businesses/{slug}/track

Ghi nhận lượt bấm liên hệ (gọi, nhắn, chỉ đường, website, chia sẻ)

  • slug (bắt buộc) — Slug

Đặt lịch

GET/api/v1/businesses/{slug}/availability

Giờ còn trống để đặt lịch / đặt bàn (giờ địa phương doanh nghiệp)

  • slug (bắt buộc) — Slug
  • date (bắt buộc) — YYYY-MM-DD
  • kind — appointment | table

Niềm tin

POST/api/v1/reports

Báo cáo nội dung

Cộng đồng

GET/api/v1/events

Sự kiện sắp diễn ra

  • city — id thành phố
GET/api/v1/events/{slug}/ics

Xuất lịch .ics

  • slug (bắt buộc) — Slug sự kiện

Tin rao

GET/api/v1/listings

Tin rao (việc làm, nhà ở, mua bán)

  • kind (bắt buộc) — job | housing | market
  • city — id thành phố

Thanh toán

GET/api/v1/plans

Bảng giá gói (VNĐ, kèm JPY/PHP tham khảo)

GET/api/v1/orders/{code}cần đăng nhập

Trạng thái đơn hàng

  • code (bắt buộc) — Mã đơn (NN…)