Trước khi thuê công ty tích hợp API ở Dubai

Ba báo giá nằm trên bàn. Công ty tích hợp nào cũng có danh mục trang du lịch, công ty nào cũng hứa sẽ "kết nối API vé máy bay vào website của bạn", và bên rẻ nhất có thể bắt đầu ngay tuần sau. Bạn điều hành một đại lý ở Deira với sáu nhân viên và lượng khách doanh nghiệp ổn định, và bạn đã mệt với việc chép giá từ extranet của nhà cung cấp sang tin nhắn WhatsApp. Chọn công ty tích hợp API ở Dubai trông có năng lực nhất có vẻ là toàn bộ quyết định.
Thực ra nó chỉ là khoảng một phần ba. Những quyết định định đoạt trang có bán được hay không không nằm trong báo giá nào, vì chúng không phải là mã. Chúng là chuyện nhà cung cấp ký hợp đồng với ai, vé xuất dưới tên ai, tiền nằm ở đâu giữa lúc đặt chỗ và lúc xuất vé, và ai xử lý hoàn tiền khi khách hủy. Bên tích hợp có thể nối tất cả lại với nhau. Họ không thể thay bạn trở thành bất kỳ phần nào trong đó.
Bài này viết cho người chủ sẽ ký bản phạm vi công việc, không phải cho lập trình viên sẽ đọc nó.
Công ty tích hợp API ở Dubai làm được gì, và không làm được gì
Một công ty tích hợp viết phần mã nằm giữa API của nhà cung cấp và website của bạn: ô tìm kiếm, lệnh gọi hỏi chỗ trống, bước kiểm tra giá trước khi thanh toán, yêu cầu đặt chỗ, các màn hình hiển thị kết quả và, nếu phạm vi có ghi, các lệnh gọi hủy và hoàn tiền. Bên giỏi còn lo những phần nhàm chán nhưng quan trọng: thử lại khi nhà cung cấp không phản hồi, nhật ký giúp truy vết một lượt đặt chỗ thất bại, môi trường thử nghiệm vận hành giống hệt môi trường thật.
Thứ họ không thể giao cho bạn là mọi thứ ở phía bên kia của đoạn mã đó. Trước khi dòng mã đầu tiên được viết, đại lý cần:
- một tài khoản nhà cung cấp đứng tên chính đại lý, với quyền truy cập API cấp cho tài khoản đó;
- thẩm quyền xuất vé, hoặc là chứng nhận của riêng đại lý, hoặc một nhà gom vé xuất thay mặt đại lý;
- một thỏa thuận tài chính với nhà cung cấp đó: tiền ký quỹ, hạn mức tín dụng hoặc thanh toán thẻ được chuyển tiếp;
- một người làm phần việc sau khi xuất vé (void, hoàn vé, xuất lại, thay đổi lịch bay), qua API hoặc, nếu không được, làm tay.
Một bên tích hợp đề nghị "lo luôn phía nhà cung cấp" thường là đang đề nghị cho bạn mượn tài khoản của họ. Làm lối tắt cho bản thử nghiệm thì có thể hợp lý. Với một doanh nghiệp, điều đó có nghĩa trang đặt chỗ của bạn chạy trên một mối quan hệ bạn không nắm giữ và không thể mang theo.
Bản yêu cầu: bảy dòng cho phạm vi công việc
Phần lớn tranh chấp với bên tích hợp đều quy về một câu không ai viết ra. Đưa những điểm sau vào tài liệu bạn ký, bằng lời lẽ đơn giản, và yêu cầu từng câu trả lời bằng văn bản.
- Tài khoản nhà cung cấp và khóa API đứng tên ai. Đứng tên đại lý. Khóa là thông tin đăng nhập: chúng nằm trong trình quản lý mật khẩu của bạn, bên tích hợp được cấp quyền truy cập, không phải quyền sở hữu.
- Ai lưu trữ trang và ai giữ tên miền. Tên miền đăng ký dưới tên đại lý. Tài khoản hosting là của đại lý, hoặc hợp đồng ghi rõ cách chuyển giao.
- Những thao tác nào nằm trong phạm vi. Liệt kê từng tên: tìm kiếm, báo giá, đặt chỗ, xuất vé, hủy, hoàn tiền, thay đổi. Thứ gì không có trong danh sách sẽ mãi là một email gửi quầy nhà cung cấp suốt vòng đời của trang. Hoàn tiền và thay đổi là hai thứ hay bị bỏ sót nhất, vì bản demo không bao giờ cho thấy chúng.
- Ai bảo trì khi nhà cung cấp đổi API. Nhà cung cấp ngừng phiên bản và đổi tên trường dữ liệu. Một dự án trọn gói không có điều khoản bảo trì sẽ kết thúc vào đúng ngày phiên bản đầu tiên thay đổi.
- Bàn giao nghĩa là gì. Mã nguồn trong một kho mã do đại lý sở hữu, mọi thông tin đăng nhập, và một tài liệu giúp lập trình viên khác tiếp quản. "Chúng tôi sẽ gửi file zip" không phải là bàn giao.
- Chứng minh việc đưa vào vận hành thế nào. Một lượt đặt thử từ tìm kiếm đến xuất vé trên môi trường thử nghiệm của nhà cung cấp, kể cả một lần hủy, trước khi bất kỳ ai trừ tiền thẻ của khách thật.
- Dữ liệu khách hàng sẽ ra sao. Tên hành khách, thông tin hộ chiếu và mã tham chiếu thanh toán: lưu ở đâu, ai được đọc, và xóa bằng cách nào.
Không điểm nào cần nền tảng kỹ thuật mới viết được. Điểm nào cũng rẻ hơn khi thỏa thuận trước lúc xây dựng so với đàm phán sau đó.
Ba cách đưa sản phẩm của nhà cung cấp lên trang của bạn
Thuê bên tích hợp nối với API của nhà cung cấp là một con đường. Nên đặt nó cạnh hai con đường còn lại trước khi một bản báo giá chọn thay bạn.
| Con đường | Ai nắm mối quan hệ với nhà cung cấp | Ai giữ cho kết nối hoạt động | Đại lý vẫn phải xây gì | Chi phí khi rời đi |
|---|---|---|---|---|
| Bên tích hợp nối trang của bạn với API của nhà cung cấp | Đại lý, nếu bản yêu cầu ghi vậy; nếu không, thường là bên tích hợp | Bên tích hợp theo hợp đồng bảo trì, hoặc không ai cả | Trang quản trị, phụ phí, hồ sơ khách hàng, báo cáo, thanh toán, màn hình dịch vụ sau bán | Ít nếu mã và khóa là của bạn; làm lại từ đầu nếu không |
| Bên tích hợp nối trang của bạn với API của một nền tảng | Nền tảng nắm hợp đồng nhà cung cấp; đại lý nắm tài khoản của mình trên nền tảng | Nền tảng lo phía nhà cung cấp; bên tích hợp lo phía bạn | Trang của bạn, và những gì API của nền tảng không bao phủ | Viết lại phía của bạn theo một API khác |
| Cửa hàng white-label đã được kết nối sẵn | Nền tảng, thông qua tài khoản của đại lý | Nền tảng | Nội dung, quyết định về giá, khách hàng của chính bạn | Chuyển tên miền và danh sách khách hàng sang nhà cung cấp khác |
Dòng đáng tranh luận là dòng đầu tiên. Nó cho nhiều quyền kiểm soát nhất và đặt lên vai bạn nhiều nhất: mỗi thay đổi của nhà cung cấp, mỗi dịch vụ mới và mỗi thao tác mà lần xây đầu bỏ sót đều trở thành một dự án mới với một báo giá mới.
Cách thêm tìm kiếm vào một trang bạn đang chạy được bàn trong thêm tìm kiếm chuyến bay vào website có sẵn, còn API của ai đứng sau nó thì ở điều gì đứng sau một nhà cung cấp API đặt vé máy bay. Bài này nói về hợp đồng bao quanh công việc.
Nền tảng này đứng ở đâu
Nền tảng đứng sau blog này cung cấp API vé máy bay và khách sạn. Quyền truy cập bắt đầu bằng một cuộc trao đổi chứ không phải một khóa tự phục vụ, vì những câu hỏi đầu tiên là các câu ở trên (dịch vụ nào, thị trường nào, tiền đi thế nào) chứ không phải gọi endpoint nào. Dịch vụ được kích hoạt theo từng tài khoản, và mỗi tài khoản có bảng quản trị riêng với đặt chỗ, khách hàng, phụ phí và báo cáo riêng, nên cột "vẫn phải xây" ở dòng thứ hai ngắn hơn vẻ ngoài.
Nếu một công ty tích hợp sẽ xây phía của bạn, hãy có cuộc trao đổi đó trước khi nhận báo giá, để phạm vi mô tả đúng API mà họ sẽ thực sự kết nối. Trang API du lịch là nơi bắt đầu.
Một bản yêu cầu sơ sài khiến bạn mất gì
Trang chạy thật. Tìm kiếm hoạt động, giá trông đúng, và lượt đặt chỗ đầu tiên đến vào tối thứ Năm. Vé không thể xuất dưới tên bạn, vì tài khoản nhà cung cấp thuộc về bên tích hợp và xuất vé theo thỏa thuận của họ. Thẻ của khách đã bị trừ tiền. Giờ bạn giữ một lượt đặt chỗ mà không thể xuất vé cũng không thể hoàn tiền qua chính trang của mình.
Hoặc nó chạy được một năm. Rồi nhà cung cấp chuyển sang phiên bản API mới, việc đặt chỗ ngừng lại, và bên tích hợp, với hợp đồng trọn gói đã kết thúc từ lúc bàn giao, gửi báo giá cho một dự án mới. Bạn trả tiền, vì những người duy nhất hiểu mã nguồn là chính những người đang báo giá.
Hoặc bên tích hợp đơn giản là đang bận việc khác. Một khách cần sửa tên trên vé, thao tác thay đổi chưa bao giờ nằm trong phạm vi, và hai nhân viên của bạn mất cả buổi chiều gửi email cho quầy nhà cung cấp. Đúng phần việc mà trang lẽ ra phải gánh thay.
Mỗi trường hợp là một câu còn thiếu trong bản yêu cầu. Lần nào phần mã cũng ổn cả.