Unua API-Voko

Gvidilo por fari vian unuan vokon al la Militant API.

1. Kontroli ke la API funkcias

curl https://via-instanco.com/api/v1/

Vi devus vidi la liston de finpunktoj en JSON.

2. Aŭtentikigi

curl -X POST https://via-instanco.com/api/v1/auth.php \
  -H "Content-Type: application/json" \
  -d '{
    "username": "via_uzantonomo",
    "password": "via_pasvorto"
  }'

Respondo:

{
  "success": true,
  "token": "abc123def456...",
  "expires_at": "2026-03-04 12:00:00",
  "user_id": 1
}

Kopiu la ĵetonon, vi bezonos ĝin por ĉiuj sekvaj vokoj.

3. Fari aŭtentikigitan vokon

Ricevi la novaĵfluon

curl https://via-instanco.com/api/v1/posts.php \
  -H "Authorization: Bearer VIA_ĴETONO"

Krei afiŝon

curl -X POST https://via-instanco.com/api/v1/posts.php \
  -H "Authorization: Bearer VIA_ĴETONO" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Mia unua afiŝo per la API!"
  }'

Ricevi vian profilon

curl https://via-instanco.com/api/v1/users.php?username=via_uzantonomo \
  -H "Authorization: Bearer VIA_ĴETONO"

4. Trakti erarojn

Nevalida ĵetono (401)

{
  "success": false,
  "error": "Invalid or expired token"
}

Solvo: Ensalutu denove por ricevi novan ĵetonon.

Peto-limo superita (429)

{
  "success": false,
  "error": "Rate limit exceeded"
}

Solvo: Atendu 1 horon aŭ reduktu la nombron de petoj.

Sekvaj paŝoj

Retour au Wiki