Bắt đầu với Zonos API

Lưu ý: Zonos hiện sử dụng GraphQL làm API chính với hỗ trợ đầy đủ các tính năng. Các điểm cuối REST được duy trì chỉ với hỗ trợ giới hạn cho các tích hợp kế thừa. Để tích hợp mới, vui lòng sử dụng GraphQL API của chúng tôi.

REST API của Zonos cung cấp các URL định hướng theo tài nguyên, trả về phản hồi được mã hóa JSON, chấp nhận thân yêu cầu được mã hóa biểu mẫu và sử dụng các mã phản hồi HTTP tiêu chuẩn và xác thực.

Để truy cập Zonos API, bạn cần có khóa API. Khóa API tương tự sẽ được sử dụng cho các mục đích thử nghiệm và khi tích hợp đã hoạt động. Khóa API được sử dụng để xác thực các yêu cầu.

Theo định kỳ, chúng tôi sẽ thêm các trường vào API của mình. Để ngăn chặn lỗi sau khi bạn đã tích hợp với API của chúng tôi, chúng tôi khuyến nghị bỏ qua các trường không xác định.

Xác thực 

Zonos sử dụng các khóa API để cho phép truy cập vào API. Bạn có thể đăng ký tài khoản Zonos mới và khóa API tại đây.

Khóa API sẽ được đưa vào tất cả các yêu cầu API tới máy chủ trong tiêu đề có dạng như sau:

serviceToken: meowmeowmeow

Lưu ý: Hãy chắc chắn thay thế meowmeowmeow bằng khóa API của bạn.

Phiên bản 

Để truy cập phiên bản REST API, hãy gửi tiêu đề zonos-version. Xem tài liệu API tương ứng để biết thông tin tiêu đề thích hợp, nếu có và cần thiết.

Nếu không chỉ định phiên bản, mặc định sẽ được đặt thành phiên bản được hỗ trợ lần cuối.

Tiêu đề phiên bản hiện tại là zonos-version: 2021-01-01.