Hủy tạm ngưng nhà phát triển

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

Tính năng Kiếm tiền cung cấp một bộ API mà bạn có thể sử dụng để huỷ trạng thái tạm ngưng cho một nhà phát triển từng bị tạm ngưng, như mô tả trong các phần sau. Nhà phát triển có thể bị tạm ngưng nếu đạt đến giới hạn đã định cấu hình. Ví dụ: số lượng giao dịch đã đạt đến hạn mức tối đa hoặc số dư tài khoản trả trước đã hết. Để xem danh sách đầy đủ các mã lý do, hãy xem phần Tóm tắt mã lý do dành cho nhà phát triển bị tạm ngưng.

Xem tất cả nhà phát triển bị tạm ngưng bằng API

Xem tất cả nhà phát triển bị tạm ngưng của một tổ chức bằng cách gửi yêu cầu GET đến tài nguyên sau: /organizations/{org_name}/suspended-developers.

Trong trường hợp:

  • {org_name} chỉ định tên của tổ chức.

Ví dụ: lệnh gọi cURL sau đây liệt kê tất cả nhà phát triển bị tạm ngưng đối với myorg:

curl -H "Content-Type: application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/suspended-developers" \
-u email:password

Sau đây là ví dụ về nội dung phản hồi:

[
  {
    "creationDate": 1464388723633,
    "devId": "myorg@@@6Vro7VnjUhpGVn3p",
    "id": "myorg-myorg@@@6Vro7VnjUhpGVn3p-myorg@@@myproduct-null-RATE_PLAN_RATE_BAND_EXCEEDED",
    "message": "mint.productHasBeenSuspended for myorg@@@6Vro7VnjUhpGVn3p myorg@@@myproduct due to RATE_PLAN_RATE_BAND_EXCEEDED",
    "orgId": "myorg",
    "prodId": "myorg@@@myproduct",
    "reasonCode": "RATE_PLAN_RATE_BAND_EXCEEDED"
  },
  {
    "creationDate": 1464022846293,
    "devId": "myorg@@@vXh7LXxtUy9COVdy",
    "id": "myorg-myorg@@@vXh7LXxtUy9COVdy-myorg@@@myproduct-null-NO_CURRENT_PUBLISHABLE_ENTITY",
    "message": "mint.productHasBeenSuspended for myorg@@@vXh7LXxtUy9COVdy myorg@@@myproduct due to mint.noCurrentPublishableEntity",
    "orgId": "myorg",
    "prodId": "myorg@@@myproduct",
    "reasonCode": "NO_CURRENT_PUBLISHABLE_ENTITY"
  }
]

Xem nhà phát triển bị tạm ngưng bằng API

Xem nhà phát triển bị tạm ngưng của một tổ chức bằng cách gửi yêu cầu GET đến tài nguyên sau: /organizations/{org_name}/suspended-developers/{developer_email_or_id}.

Trong trường hợp:

  • {org_name} chỉ định tên của tổ chức.
  • {developer_email_or_id} chỉ định mã nhận dạng của nhà phát triển. Để xem danh sách nhà phát triển, hãy xem bài viết Danh sách nhà phát triển.

Ví dụ: lệnh gọi cURL sau đây liệt kê thông tin chi tiết về nhà phát triển bị tạm ngưng joe@example.com:

curl -H "Content-Type: application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/suspended-developers/joe@example.com" \
-u email:password

Sau đây là ví dụ về nội dung phản hồi:

[
  {
    "creationDate": 1464388723633,
    "devId": "myorg@@@6Vro7VnjUhpGVn3p",
    "id": "myorg-myorg@@@6Vro7VnjUhpGVn3p-myorg@@@myproduct-null-RATE_PLAN_RATE_BAND_EXCEEDED",
    "message": "mint.productHasBeenSuspended for myorg@@@6Vro7VnjUhpGVn3p myorg@@@myproduct due to RATE_PLAN_RATE_BAND_EXCEEDED",
    "orgId": "myorg",
    "prodId": "myorg@@@myproduct",
    "reasonCode": "RATE_PLAN_RATE_BAND_EXCEEDED"
  }
]

Huỷ tạm ngưng tất cả nhà phát triển cho một sản phẩm API bằng API

Huỷ tạm ngưng tất cả nhà phát triển đã bị tạm ngưng đối với một sản phẩm API bằng cách gửi yêu cầu POST đến tài nguyên sau: /organizations/{org_name}/suspended-developers/unsuspend-by-product/{suspendedProduct_id}.

Trong trường hợp:

Ví dụ: lệnh gọi cURL sau đây sẽ huỷ tạm ngưng tất cả nhà phát triển cho sản phẩm API myorg@@@myproduct:

curl -H "Content-Type: application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/suspended-developers/unsuspend-by-product/myorg@@@myproduct" \
-u email:password

Huỷ tạm ngưng nhà phát triển bằng API

Huỷ tạm ngưng một nhà phát triển cụ thể đã bị tạm ngưng bằng cách đưa ra yêu cầu XOÁ đối với tài nguyên sau: /organizations/{org_name}/suspended-developers/{suspendedDev_id}.

Trong trường hợp:

Nếu muốn, bạn có thể chuyển tham số truy vấn sau:

Tham số truy vấn Mô tả
suspendedProduct_id Mã nhận dạng của sản phẩm API, sử dụng định dạng tương tự như sau: {org_id}@@@{product_id}. Giá trị này được trả về dưới dạng prodId khi bạn xem tất cả hoặc một số nhà phát triển cụ thể bị tạm ngưng, như mô tả trong phần Xem tất cả nhà phát triển bị tạm ngưng bằng API và Xem một nhà phát triển bị tạm ngưng bằng API.

Ví dụ: lệnh gọi cURL sau đây sẽ huỷ tạm ngưng nhà phát triển có mã nhận dạng myorg@@@6Vro7VnjUhpGVn3p cho sản phẩm API myorg@@@myproduct:

curl -H "Content-Type: application/json" -X DELETE \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/suspended-developers/myorg@@@6Vro7VnjUhpGVn3p?productId=myorg@@@myproduct" \
-u email:password

Tóm tắt mã lý do cho nhà phát triển bị tạm ngưng

Bảng sau đây tóm tắt các mã lý do cho biết lý do nhà phát triển bị tạm ngưng.

Mã lý do Mô tả
INSUFFICIENT_FUNDS Tài khoản nhà phát triển đã hết hạn.
LIMIT_VIOLATED Đã đạt đến giới hạn thiết lập cho tài khoản nhà phát triển.
NO_CURRENT_PUBLISHABLE_ENTITY Nhà phát triển chưa chấp nhận (đã đăng ký) gói giá.
RATE_PLAN_RATE_BAND_EXCEEDED Đã đạt đến giới hạn được định cấu hình của dải âm lượng cuối cùng.