API λογαριασμού2026-11Προεπισκόπηση

Υπόλοιπο

Τα χρήματα από τα οποία πληρώνονται οι παραγγελίες σας, σε CN¥. Τα προσθέτετε στο ninjabuy.com· το API τα διαβάζει και δεν χρεώνει ποτέ κάρτα.

Μια παραγγελία που δεν καλύπτει το υπόλοιπό σας περιμένει ως awaiting_payment και προχωρά μόνη της μετά από φόρτιση.
Οι επιστροφές χρημάτων, για ακυρωμένη παραγγελία ή γραμμή που δεν μπορέσαμε να αγοράσουμε, επιστρέφουν στο υπόλοιπο. Οι Χρεώσεις αναφέρουν κάθε χρέωση.

Endpoints

GET/v1/balanceΑνάκτηση υπολοίπου
GET/v1/balance/transactionsΛίστα συναλλαγών

Το αντικείμενο Balance

availablemoney: Τι μπορούν να ξοδέψουν οι νέες παραγγελίες, σε CN¥.
reservedmoney: Δεσμευμένο για παραγγελίες που αγοράζονται και δέματα που περιμένουν ζύγιση.
top_up_urlstring: Πού προσθέτετε χρήματα, συνδεδεμένοι στο ninjabuy.com.

balance

{
  "available": { "amount": "2140.00", "currency": "CNY" },
  "reserved": { "amount": "264.20", "currency": "CNY" },
  "top_up_url": "https://www.ninjabuy.com/me/balance/top-up",
  "updated_at": "2026-11-04T09:20:03Z"
}

Ανάκτηση υπολοίπου

GET/v1/balance

Ελέγξτε το πριν στείλετε μεγάλη παρτίδα παραγγελιών.

Scopebalance:read

curl "https://www.ninjabuy.com/api/v1/balance" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "available": { "amount": "2140.00", "currency": "CNY" },
  "reserved": { "amount": "264.20", "currency": "CNY" },
  "top_up_url": "https://www.ninjabuy.com/me/balance/top-up",
  "updated_at": "2026-11-04T09:20:03Z"
}

Λίστα συναλλαγών

GET/v1/balance/transactions

Φορτίσεις, χρεώσεις παραγγελιών και αποστολής, και επιστροφές χρημάτων, οι νεότερες πρώτα. Τα ποσά έχουν πρόσημο: μια χρέωση είναι αρνητική.

Scopebalance:read

Παράμετροι ερωτήματος

typestring: Προαιρετικό. top_up, order, shipping ή refund.
orderstring: Προαιρετικό. Ένα id παραγγελίας: όλες οι κινήσεις αυτής της παραγγελίας.
limit, cursor: Pagination

curl "https://www.ninjabuy.com/api/v1/balance/transactions?limit=3" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "data": [
    {
      "id": "txn_k22a",
      "type": "shipping",
      "order": "ord_3n7q",
      "amount": { "amount": "-134.52", "currency": "CNY" },
      "created_at": "2026-11-03T05:58:00Z"
    },
    {
      "id": "txn_k21d",
      "type": "order",
      "order": "ord_3n7q",
      "amount": { "amount": "-57.00", "currency": "CNY" },
      "created_at": "2026-11-01T09:14:02Z"
    },
    {
      "id": "txn_k1zz",
      "type": "top_up",
      "order": null,
      "amount": { "amount": "2000.00", "currency": "CNY" },
      "created_at": "2026-10-31T16:40:12Z"
    }
  ],
  "has_more": true,
  "cursor": "c_k1zz"
}