Đăng ký nhà phát triển ứng dụng

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X. thông tin

Đăng ký và quản lý nhà phát triển ứng dụng của bạn như mô tả trong các phần sau. (Quy trình đăng ký ứng dụng là một quy trình riêng biệt, như mô tả trong phần Đăng ký ứng dụng và quản lý khoá API).

Giới thiệu

Edge mang lại nhiều lợi ích hoàn toàn phụ thuộc vào việc biết ai đang gọi API của bạn. Ví dụ: tính năng bảo mật API, quản lý lưu lượng truy cập và một lượng dữ liệu phân tích hợp lý phụ thuộc vào việc biết ai đang gọi. Và làm cách nào để Edge biết ai đang gọi API của bạn? Bằng cách đọc thông tin duy nhất trong mỗi lệnh gọi API, chẳng hạn như mã nhận dạng người dùng, khoá API hoặc mã thông báo OAuth. Thông tin duy nhất đó sẽ khoá hoặc mở khoá chức năng mà bạn tạo vào proxy API, cho phép bạn kiểm soát toàn bộ quyền truy cập và hành vi của API.

Đó là lý do nhà phát triển ứng dụng cần đăng ký để sử dụng API của bạn. Sau khi thêm, nhà phát triển sẽ đăng ký ứng dụng, chọn API mà họ muốn sử dụng và nhận thông tin xác thực API riêng biệt (khoá và khoá bí mật của người dùng) cần thiết để truy cập vào API của bạn.

Cách đăng ký nhà phát triển ứng dụng

Đăng ký nhà phát triển ứng dụng bằng một trong các phương thức sau:

Đề xuất về cách quản lý tài khoản nhà phát triển trên cổng thông tin dành cho nhà phát triển

Apigee khuyên bạn nên quản lý tài khoản nhà phát triển ngay trên cổng thông tin dành cho nhà phát triển.

Nếu bạn đang sử dụng cổng thông tin tích hợp, đây là cách duy nhất để đảm bảo rằng các tài khoản nhà phát triển trên cổng thông tin tích hợp và Edge luôn đồng bộ.

Nếu bạn sử dụng cổng thông tin dành cho nhà phát triển dựa trên Drupal, thì việc quản lý tài khoản nhà phát triển trực tiếp trên cổng thông tin dành cho nhà phát triển sẽ mang lại những lợi ích sau:

  • Khi thêm nhà phát triển thông qua giao diện quản trị viên trên cổng thông tin, bạn có thể đặt mật khẩu của nhà phát triển cho cổng thông tin và kích hoạt một email tự động gửi đến nhà phát triển.

    Khi thêm hoặc sửa đổi nhà phát triển bằng Edge, hệ thống sẽ không gửi email cho nhà phát triển và bạn không thể đặt mật khẩu cho nhà phát triển trên cổng thông tin. Do đó, nhà phát triển phải đặt lại mật khẩu trên cổng thông tin thì mới có thể đăng nhập vào cổng thông tin.

  • Mọi thay đổi đối với tài khoản của nhà phát triển trên cổng thông tin sẽ tự động được gửi đến Edge.

Nếu quyết định quản lý các tài khoản nhà phát triển dựa trên Drupal bằng Edge, bạn phải đồng bộ hoá nhà phát triển ứng dụng giữa cổng thông tin và Edge.

Khám phá Trang dành cho nhà phát triển

Truy cập và khám phá trang dành cho nhà phát triển bằng giao diện người dùng Edge và giao diện người dùng Edge cũ.

Edge

Cách truy cập vào Trang dành cho nhà phát triển bằng giao diện người dùng Edge:

  1. Đăng nhập vào apigee.com/edge.
  2. Chọn Xuất bản > Nhà phát triển trong thanh điều hướng bên trái.

Trang dành cho nhà phát triển sẽ xuất hiện.

Như được làm nổi bật trong hình, trang Nhà phát triển cho phép bạn:

Edge phiên bản cũ (Đám mây riêng)

Cách truy cập vào trang Nhà phát triển bằng giao diện người dùng Edge cũ:

  1. Đăng nhập vào http://ms-ip:9000, trong đó ms-ip là địa chỉ IP hoặc tên DNS của nút Máy chủ quản lý.
  2. Chọn Xuất bản > Nhà phát triển trong thanh điều hướng trên cùng.

Trang dành cho nhà phát triển sẽ xuất hiện.

Thêm nhà phát triển

Cách thêm nhà phát triển:

  1. Truy cập vào Trang dành cho nhà phát triển.
  2. Nhấp vào + Nhà phát triển.
  3. Nhập thông tin chi tiết về nhà phát triển, bao gồm tên, họ, email và tên người dùng.
  4. Nhấp vào Tạo.

Xem và chỉnh sửa thông tin chi tiết của nhà phát triển

Xem và chỉnh sửa thông tin chi tiết của nhà phát triển. Đối với các tổ chức đã bật tính năng Kiếm tiền, bạn có thể chỉnh sửa các thuộc tính tuỳ chỉnh về việc kiếm tiền được xác định trong bài viết Định cấu hình thuộc tính về việc kiếm tiền.

Cách xem và chỉnh sửa thông tin chi tiết về nhà phát triển:

  1. Truy cập vào Trang dành cho nhà phát triển.
  2. Nhấp vào hàng của nhà phát triển mà bạn muốn xem và chỉnh sửa để mở thông tin chi tiết về nhà phát triển.
  3. Trong phần Chi tiết, bạn sẽ thấy những thông tin sau. Chỉnh sửa thông tin về nhà phát triển (nếu cần).
    Chi tiết Mô tả
    Thông tin chi tiết Họ và tên, tên người dùng và email của nhà phát triển; trạng thái và thời hạn đăng ký; cũng như mã nhận dạng nhà phát triển.
    Để chỉnh sửa thông tin chi tiết về nhà phát triển, hãy nhấp vào bất kỳ trường nào sau đây:
    • Tên
    • Họ
    • Email
    • Tên người dùng
    Sửa đổi nội dung rồi nhấn phím Enter để xác nhận thay đổi.
    Thuộc tính tùy chỉnh Thuộc tính tuỳ chỉnh được xác định cho nhà phát triển. Định cấu hình các thuộc tính tuỳ chỉnh (nếu cần). Để biết thêm thông tin, hãy xem:
    Ứng dụng Ứng dụng đã được nhà phát triển đăng ký. Xem phần Đăng ký ứng dụng.
  4. Kích hoạt hoặc huỷ kích hoạt nhà phát triển trong trường Trạng thái.
    Để biết thêm thông tin, hãy xem bài viết Kích hoạt và huỷ kích hoạt nhà phát triển.

Với Apigee Edge cho đám mây công cộng, Edge lưu giữ các thực thể sau trong bộ nhớ đệm trong tối thiểu 180 giây sau khi các thực thể đó được truy cập.

  • Mã truy cập OAuth. Điều này có nghĩa là mã thông báo bị thu hồi vẫn có thể thành công trong tối đa 3 phút cho đến khi giới hạn bộ nhớ đệm của mã thông báo đó hết hạn.
  • Các thực thể Dịch vụ quản lý khoá (KMS) (Ứng dụng, Nhà phát triển, Sản phẩm API).
  • Thuộc tính tuỳ chỉnh trên mã thông báo OAuth và thực thể KMS.

Quản lý thuộc tính tuỳ chỉnh cho nhà phát triển

Thêm tối đa 18 thuộc tính tuỳ chỉnh cho mỗi nhà phát triển, bao gồm cả các thuộc tính kiếm tiền được mô tả trong phần Định cấu hình thuộc tính kiếm tiền.

Cách quản lý thuộc tính tuỳ chỉnh:

  1. Truy cập vào Trang dành cho nhà phát triển.
  2. Nhấp vào hàng của nhà phát triển mà bạn muốn quản lý thuộc tính tuỳ chỉnh để mở thông tin chi tiết về nhà phát triển đó.
  3. Nhấp vào dấu + trong mục Thuộc tính tuỳ chỉnh.
  4. Nhập tên và giá trị thuộc tính.
  5. Nhấp vào .
  6. Để xoá một thuộc tính tuỳ chỉnh, hãy di chuột qua thuộc tính đó rồi nhấp vào trong trình đơn thao tác.

Kích hoạt và huỷ kích hoạt nhà phát triển

Khi nhà phát triển ứng dụng tự đăng ký trong cổng thông tin của bạn, bạn có thể định cấu hình xem họ có đang hoạt động theo mặc định hay không.

Khi không hoạt động, nhà phát triển vẫn có thể đăng nhập vào cổng thông tin dành cho nhà phát triển và tạo ứng dụng, nhưng không có khoá API tương ứng nào hoạt động. Các ứng dụng của nhà phát triển vẫn giữ nguyên trạng thái đã phê duyệt (hoặc trạng thái khác), cũng như các khoá API, mặc dù các trạng thái này không hợp lệ khi nhà phát triển không hoạt động.

Cách kích hoạt hoặc huỷ kích hoạt nhà phát triển:

  1. Truy cập vào Trang dành cho nhà phát triển.
  2. Nhấp vào hàng của nhà phát triển mà bạn muốn kích hoạt hoặc huỷ kích hoạt để mở thông tin chi tiết về nhà phát triển.
  3. Trong mục Chi tiết, hãy đặt trường Trạng thái thành Đang hoạt động hoặc Không hoạt động (nếu cần).
  4. Lặp lại các bước nếu nhà phát triển thuộc nhiều tổ chức.

Xuất dữ liệu phát hành

Xuất dữ liệu phát hành sau đây dưới dạng tệp chứa các giá trị được phân tách bằng dấu phẩy (CSV):

  • Chi tiết của Nhà phát triển
  • Thông tin chi tiết về nhà phát triển, ứng dụng và sản phẩm API

Cách xuất dữ liệu xuất bản:

  1. Truy cập vào Trang dành cho nhà phát triển.
  2. Nhấp vào Xuất CSV...
  3. Chọn Nhà phát triển hoặc Nhà phát triển, ứng dụng và sản phẩm trong trình đơn thả xuống.

Dữ liệu phát hành đã chọn sẽ được tải xuống dưới dạng tệp CSV.

Xoá nhà phát triển

Cách xoá nhà phát triển:

  1. Truy cập vào Trang dành cho nhà phát triển.
  2. Đặt con trỏ lên hàng của nhà phát triển mà bạn muốn xoá để hiển thị trình đơn thao tác.
  3. Nhấp vào .
  4. Nhấp vào Xoá để xác nhận việc xoá.

Đồng bộ hoá nhà phát triển ứng dụng giữa cổng thông tin và Edge

Nếu bạn đang sử dụng cổng thông tin dành cho nhà phát triển dựa trên Drupal để phát hành API, thì các thay đổi đối với nhà phát triển ứng dụng sử dụng Edge sẽ không được truyền đến cổng thông tin. Bạn phải đăng nhập vào cổng thông tin với tư cách là quản trị viên cổng thông tin và đồng bộ hoá cổng thông tin với Edge để những thay đổi đó xuất hiện trên cổng thông tin.

Để đồng bộ hoá cổng thông tin dành cho nhà phát triển với các nhà phát triển ứng dụng được xác định trên Edge, hãy tham khảo các phần sau:

Nhóm nhà phát triển thành công ty

Đối với hoạt động kiếm tiền, công ty là một tập hợp các nhà phát triển được quản lý dưới dạng một pháp nhân duy nhất. Công ty có thể là bất kỳ nhóm nào phù hợp với tổ chức của bạn, chẳng hạn như đơn vị kinh doanh, dòng sản phẩm hoặc bộ phận. Việc nhóm các nhà phát triển thành công ty sẽ hữu ích khi bạn cần liên kết nhiều nhà phát triển trong một pháp nhân công ty. Ví dụ: bạn có thể cần thiết lập nhiều công ty cho mục đích thanh toán. Tuy nhiên, các nhà phát triển trong tổ chức của bạn không cần phải liên kết với một công ty. Xin lưu ý rằng nhà phát triển luôn là một thực thể duy nhất, được xác định riêng biệt bằng phần tử email. Nếu một nhà phát triển thuộc một công ty, bạn sẽ thấy tên Công ty trên trang Nhà phát triển.

Để biết thêm thông tin về cách quản lý công ty và nhà phát triển nhằm kiếm tiền, hãy xem bài viết Quản lý công ty và nhà phát triển.

Định cấu hình thuộc tính kiếm tiền

Khi chỉnh sửa nhà phát triển bằng giao diện người dùng hoặc tạo hoặc chỉnh sửa nhà phát triển bằng API, bạn có thể định cấu hình các thuộc tính kiếm tiền được xác định trong bảng sau. Ban đầu, bạn định cấu hình các thuộc tính kiếm tiền cho tổ chức khi chỉnh sửa hồ sơ tổ chức.

Tên trường Tên thuộc tính tuỳ chỉnh Mô tả
Địa chỉ MINT_DEVELOPER_ADDRESS

Địa chỉ của nhà phát triển, bao gồm các trường sau: Địa chỉ (dòng 1 và 2), Thành phố, Tiểu bang, Mã bưu chính và Quốc gia.
Hồ sơ thanh toán MINT_BILLING_PROFILE

Chu kỳ thanh toán cho tổ chức của bạn. Các giá trị hợp lệ bao gồm:

  • PRORATED: Hệ thống tính phí dựa trên số ngày mà một sản phẩm API được sử dụng trong một tháng theo lịch.
  • CALENDAR_MONTH: Hệ thống sẽ tính phí hằng tháng.
Loại thanh toán MINT_BILLING_TYPE

Mô hình thanh toán dành cho nhà phát triển dùng để lập hoá đơn. Giá trị này có thể là một trong những giá trị sau:

  • TRƯỚC TIỀN: Nhà phát triển trả trước để sử dụng một sản phẩm API. Khoản tiền sẽ được khấu trừ từ số dư của nhà phát triển khi sản phẩm API được sử dụng. Nhà phát triển phải duy trì số dư trả trước đủ để mua sản phẩm API.
  • TÍN DỤNG TRƯỚC, THANH TOÁN SAU: Nhà phát triển được tính phí hằng tháng (thông qua hoá đơn) để sử dụng các sản phẩm API. Nhà phát triển thanh toán cho việc sử dụng các sản phẩm API dựa trên các điều khoản thanh toán do(các) gói có trong hoá đơn đặt ra.
  • CẢ HAI: Hỗ trợ cả hai loại thanh toán. Giá trị mặc định là PREPAID (Trả trước).

Xem phần Định cấu hình loại thanh toán trả trước và trả sau bằng API.

Danh mục MINT_DEVELOPER_CATEGORY Danh mục nhà phát triển mà bạn muốn thêm nhà phát triển. Danh mục nhà phát triển là một nhóm các nhà phát triển hoặc công ty có đặc điểm tương tự nhau. Để biết thêm thông tin, hãy xem bài viết Quản lý danh mục nhà phát triển.
Mã công ty MINT_COMPANY_ID Mã công ty (nếu có). Để biết thêm thông tin, hãy xem phần Nhóm nhà phát triển thành công ty.
Loại nhà phát triển MINT_DEVELOPER_TYPE Apigee không sử dụng thuộc tính này.

Loại nhà phát triển. Các giá trị hợp lệ bao gồm: TRUSTED hoặc UNTRUSTED
Là bên môi giới MINT_IS_BROKER Cờ chỉ định xem doanh thu có dựa trên doanh thu ròng hay không.
Tên pháp lý MINT_DEVELOPER_LEGAL_NAME Tên pháp lý của nhà phát triển sẽ được dùng trong tất cả báo cáo.
Lưu ý: Bạn phải có thuộc tính này nếu nhà phát triển không được nhóm với một công ty và muốn đăng ký một gói giá đã xuất bản.
Tự thanh toán MINT_HAS_SELF_BILLING Cờ chỉ định liệu bạn có bật hoá đơn tự thanh toán hay không. Nếu được bật (true), tính năng kiếm tiền sẽ tạo hoá đơn tự thanh toán thay vì bảng sao kê chia sẻ doanh thu. Hoá đơn tự lập là một tài liệu tài chính nêu chi tiết số tiền phải trả cho nhà phát triển. Giấy tờ này đóng vai trò là hoá đơn cho Nhà cung cấp API thay mặt cho nhà phát triển.
Mã số uỷ quyền miễn thuế MINT_TAX_EXEMPT_AUTH_NO Mã số miễn thuế của chính phủ (nếu có).
Thuế suất MINT_APPROX_TAX_RATE Thuế suất ước tính cho nhà phát triển. Chỉ định một giá trị thập phân có tối đa 3 ký tự trước dấu thập phân và 4 ký tự sau dấu thập phân.

Quản lý nhà phát triển bằng API

Quản lý nhà phát triển bằng API dành cho nhà phát triển.

Khi tạo và cập nhật nhà phát triển bằng API, bạn có thể định cấu hình các thuộc tính kiếm tiền được mô tả trong phần Định cấu hình các thuộc tính kiếm tiền (nếu cần).