Zum Inhalt springen
NimbusNexus

Rechnungen

Rechnungen werden monatlich am 1. des Folgemonats erstellt und decken den gesamten Verbrauch des vorherigen Kalendermonats ab. Jede Rechnung ist nach Ressource und Tag aufgeschlüsselt, sodass Sie jede Position auf bestimmte VMs / Volumes / Buckets / Datenbanken zurückführen können.

Dieser Endpoint bietet programmatischen Zugriff auf dieselben Daten, die das Dashboard zeigt. Anwendungsfälle: Rechnungspositionen in Ihr eigenes System zur Kostenzuordnung einspeisen, Rechnungen für steuerliche Zwecke archivieren, Rechnungen mit Ihrem Bestellbuch abgleichen.

Rechnungen gibt es auch als PDF — dasselbe Format, das in den meisten Rechtsordnungen für die steuerliche Geltendmachung verwendet wird. Das JSON-Format ist die maßgebliche Quelle; das PDF wird aus dem JSON erzeugt.

Nächste Schritte

  • Zahlungsmethoden — womit Rechnungen bezahlt werden.
  • Preisdaten — die Preise pro Ressource, aus denen sich die Rechnungssummen ergeben.

Reference

GET/api/v1/billing/public/accrued_charges

Accrued Charges

Returns the total charges accrued by the current customer that have not yet been settled.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/billing/public/accrued_charges" \
  -H "Authorization: Bearer $NIMBUS_KEY"
GET/api/v1/billing/public/balances

Get Balances

Returns the customer's outstanding postpaid charges, available promotional credit, and prepaid cash balance in a single snapshot.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/billing/public/balances" \
  -H "Authorization: Bearer $NIMBUS_KEY"
GET/api/v1/billing/public/billing_info

Get Billing Info

Retrieves the billing address and notification email addresses for the current customer.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/billing/public/billing_info" \
  -H "Authorization: Bearer $NIMBUS_KEY"
PATCH/api/v1/billing/public/billing_info

Update Billing Info

Updates the billing address, company name, and notification email addresses for the current customer.

Request body

FieldTypeDescription
companystring | null—
addressAddressModel | null—
statement_emailstring | null—
receipt_emailstring | null—

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X PATCH "https://api.nimbusnexus.net/api/v1/billing/public/billing_info" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
GET/api/v1/billing/public/cash_balance

Get Cash Balance

Returns the current prepaid cash balance for the customer along with the timestamp it was last updated.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/billing/public/cash_balance" \
  -H "Authorization: Bearer $NIMBUS_KEY"
GET/api/v1/billing/public/promotion_grants

List Promotion Grants

Lists the customer's active promotional credit grants with their remaining amounts and expiration dates.

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/billing/public/promotion_grants" \
  -H "Authorization: Bearer $NIMBUS_KEY"

Need to make a real call? Try these endpoints in the live Swagger UI →

Edit this page on GitHub