Mga Error Code at Sanggunian sa Status

Komprehensibong gabay sa mga error code ng Smart Money API, HTTP status code, at mga hakbang sa pag-troubleshoot. Unawain ang mga tugon sa error at malutas ang mga isyu sa pagsasama nang mabilis.

Mga 2xx Success Code

Ang mga tugon ng tagumpay ay nagpapahiwatig na ang kahilingan ay matagumpay na na-proseso.

Code	Status	Kahulugan
200	OK	Matagumpay ang kahilingan. Ang katawan ng tugon ay naglalaman ng hiniling na data.
201	Created	Matagumpay na na-create ang resource. Kasama sa tugon ang bagong resource.
204	No Content	Matagumpay ang kahilingan ngunit walang content na ibabalik (hal., DELETE).

Halimbawa ng 200 Response

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [...],
    "pagination": {
      "page": 1,
      "limit": 50
    }
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Mga 4xx Client Error Code

Ang mga error ng client ay nagpapahiwatig na ang kahilingan ay hindi maayos o hindi wasto. Ayusin ang iyong kahilingan at subukan muli.

Code	Status	Sanhi
400	Bad Request	Hindi maayos na syntax ng kahilingan. Suriin ang mga query parameter, header, at katawan ng kahilingan.
401	Unauthorized	Nawawala o hindi wasto ang mga kredensyal sa pagpapatunay. Suriin ang iyong API key o JWT token.
402	Payment Required	Nabigo ang iyong subscription payment. I-update ang billing information sa iyong account.
403	Forbidden	Napatunayan ngunit hindi awtorisado para sa resource na ito. Ang iyong plano ay hindi kasama ang feature na ito.
404	Not Found	Hindi umiiral ang resource. Suriin ang endpoint URL at mga parameter.
429	Too Many Requests	Na-exceed ang rate limit. Maghintay bago mag-retry. Suriin ang Retry-After header.
422	Unprocessable Entity	Nabigo ang pagpapatunay. Hindi wasto o kulang ang mga parameter ng kahilingan sa mga kinakailangang field.

Mga Halimbawa ng Error sa Pagpapatunay

Nawawalang API Key (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "Hindi ibinigay ang mga kredensyal sa pagpapatunay.",
    "resolution": "Isama ang iyong API key sa Authorization header: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Hindi Wastong API Key (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "Hindi wasto o expired na API key.",
    "resolution": "Gumawa ng bagong API key mula sa iyong console sa https://smartmoneyapi.com/console"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Paglimit sa Rate (429)

Kapag na-exceed mo ang iyong API quota, ibabalik ng server ang 429 Too Many Requests. Suriin ang mga response header para sa impormasyon sa rate limit:

Mga HTTP Header

X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600

Tugon sa Error sa Rate Limit

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Na-exceed ang daily API request limit (10).",
    "resolution": "Mag-upgrade sa Trader ($29/month, 1,000 requests/day) o Pro ($79/month, 5,000 requests/day) plan.",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Mga Error sa Pagpapatunay (422)

Nangyayari ang mga error sa pagpapatunay kapag hindi wasto o kulang ang mga parameter ng iyong kahilingan sa mga kinakailangang field.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Nabigo ang pagpapatunay ng kahilingan.",
    "details": [
      {
        "field": "symbol",
        "error": "Hindi wastong trading pair. Inaasahang format: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "Dapat ay positibong numero"
      }
    ],
    "resolution": "Ayusin ang mga error sa pagpapatunay at subukan muli."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Mga 5xx Server Error Code

Ang mga error ng server ay nagpapahiwatig ng problema sa aming panig. Ito ay pansamantala at karaniwang nalulutas nang mabilis. Magpatupad ng exponential backoff retry logic.

Code	Status	Aksyon
500	Internal Error	Hindi inaasahang error ng server. Mag-retry gamit ang exponential backoff.
502	Bad Gateway	Pansamantalang pagkagambala sa serbisyo. Mag-retry pagkatapos ng ilang segundo.
503	Service Unavailable	Maintenance o pansamantalang outage. Suriin ang status page. Mag-retry pagkatapos ng Retry-After interval.
504	Gateway Timeout	Masyadong matagal ang kahilingan. Maaaring na-proseso ito ng server. Suriin ang idempotency.

Halimbawa ng Server Error (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Pansamantalang hindi available ang serbisyo dahil sa maintenance.",
    "resolution": "Mangyaring mag-retry pagkatapos ng 5 minuto. Subaybayan ang status sa https://status.smartmoneyapi.com"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Gabay sa Pag-troubleshoot

401 Unauthorized - Hindi Wastong API Key

Problema: Tumatanggap ng 401 error kahit may API key.

Mga Solusyon:

Patunayan na kasama ang API key sa Authorization header na may "Bearer" prefix
Suriin na hindi expired o na-revoke ang iyong API key
Siguraduhin na ginagamit mo ang tamang key (production, staging, o development)
Gumawa ng bagong API key mula sa iyong console kung nawala ang kasalukuyan

403 Forbidden - Hindi Available ang Feature

Problema: Nakakatanggap ng 403 error sa ilang endpoint.

Mga Solusyon:

Suriin ang iyong API tier. Ang ilang endpoint ay nangangailangan ng Trader o Pro plan
Mag-upgrade ng iyong plan sa /pricing.html para ma-access ang premium features
Patunayan na mayroong kinakailangang scopes ang API key
Makipag-ugnayan sa suporta kung sa tingin mo ay dapat kang magkaroon ng access

429 Too Many Requests - Na-limit sa Rate

Problema: Nakakatanggap ng 429 error at na-limit sa rate.

Mga Solusyon:

Magpatupad ng exponential backoff retry logic (maghintay ng 1s, 2s, 4s, atbp.)
I-cache ang mga tugon para maiwasan ang mga redundant na API call
Gamitin ang WebSocket para sa real-time data sa halip na mag-poll ng REST endpoint
Mag-upgrade ng iyong plan para sa mas mataas na quota (Trader 1,000/day, Pro 5,000/day)
I-batch ang maraming query sa iisang kahilingan kung posible

400 Bad Request - Hindi Wastong Mga Parameter

Problema: Nakakatanggap ng 400 error sa mga hindi maayos na kahilingan.

Mga Solusyon:

Suriin ang dokumentasyon ng API para sa mga kinakailangan at opsyonal na parameter
Patunayan ang mga uri ng parameter (string vs number, array vs object)
Siguraduhin na wasto at maayos ang format ng JSON
Gumamit ng tamang endpoint URL na may tamang path parameter
Suriin ang mga typo sa mga pangalan ng query parameter

5xx Server Errors - Pansamantalang Pagkawala ng Serbisyo

Problema: Nakakatanggap ng 500, 502, 503, o 504 na mga error.

Mga Solusyon:

Suriin ang status ng serbisyo sa https://status.smartmoneyapi.com
Magpatupad ng awtomatikong pag-retry na may exponential backoff (max 5-10 attempts)
Maghintay ng 30-60 segundo bago i-retry ang 503 errors
Gamitin ang Retry-After header para matukoy ang tamang oras ng pag-retry
Mag-subscribe sa status page para sa mga notification ng insidente

Error Response Format

Ang lahat ng error responses ay sumusunod sa pare-parehong format:

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": {...},
    "resolution": "Steps to resolve the issue"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Kailangan ng Karagdagang Tulong?

Suriin ang aming API documentation o makipag-ugnayan sa support kasama ang iyong error code at mga detalye ng request.

API Reference

Kumuha ng Suporta

May mga tanong? Suriin ang aming documentation o makipag-ugnayan sa support.

Buksan ang Console