Purchase dynamic traffic

POST /open-api/v1/dynamic/traffic/purchases

Base URL: https://api.ipfbs.com/gin.

Authentication

Send your key in the X-API-Key request header.

JSON request body

Field	Type	Required	Constraints	Meaning
request_no	string	Yes	minLength: 1; maxLength: 64; pattern: ^[A-Za-z0-9_-]{1,64}$	Caller request number for duplicate protection.
product_code	string	Yes	—	Product code returned by the products endpoint.
traffic_gb	string	Yes	—	Traffic amount in GB as a decimal string.

Request example

curl --request POST \
  --url 'https://api.ipfbs.com/gin/open-api/v1/dynamic/traffic/purchases' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "request_no": "req_20260824_001",
  "product_code": "DYNAMIC_1GB",
  "traffic_gb": "1.0"
}'

Success response data

Responses use code, msg, data, and next. HTTP 200 can also contain a nonzero business error code; check code first.

Field	Type	Required	Constraints	Meaning
data.order_no	string	No	—	Order no.
data.status	string	No	enum: COMPLETED	Current status of this resource or order.
data.product_code	string	No	—	Product code returned by the products endpoint.
data.traffic_gb	string	No	—	Traffic amount in GB as a decimal string.
data.order_amount	string	No	—	Order or quote amount as a decimal string.
data.currency	string	No	—	Currency.
data.traffic_lot_id	string	No	—	Traffic lot id.
data.finish_time	string	No	format: date-time	Finish time.

Related conventions

Request conventions · Response structure · Error codes · API reference index