Provider API dokumentáció

Minden végpont, mező, válasz és hiba egy oldalon. A példák curl-t és JSON-t használnak.

Első lépések

JSON HTTPS-en keresztül. Ügyfelenként egy hívást küldjön, valahányszor a kapcsolója változik. Minden hívás biztonságosan megismételhető.

Alap-URLhttps://api.anuto.app/v1

Végpontok

Végpont Jelentés
POST/provider/clientsÜgyfél aktiválása vagy frissítése
GET/provider/clients/{externalId}Egy ügyfél állapota
DELETE/provider/clients/{externalId}Ügyfél deaktiválása, hirdetéseinek visszavonása
POST/provider/clients/{externalId}/changesJelezze az Anutónak, hogy egy ügyfél készlete változott
GET/provider/meKulcs ellenőrzése: szolgáltató neve, formátumai és állapota

Az ismétlés biztonságos

Az ugyanazzal az externalId-val érkező hívások frissítik az ügyfelet. Sosem hoznak létre duplikátumot, így időtúllépés után nyugodtan újrapróbálkozhat.

Hitelesítés

Minden kérésben küldje el a kulcsát az Authorization fejlécben. A kulcsok anp_ előtaggal kezdődnek, csak egyszer látszanak, és az API-kulcsok oldalon lecserélhetők.

Authorization: Bearer anp_…

Ügyfél aktiválása vagy frissítése

POST/provider/clients

Amikor az ügyfél kapcsolója bekapcsol, küldje el az adatait. Ugyanazzal az externalId-val ismételt hívás frissíti ezt az ügyfelet.

curl -X POST https://api.anuto.app/v1/provider/clients \
  -H "Authorization: Bearer $ANUTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "12345",
    "name": "Casa Sol Real Estate",
    "email": "[email protected]",
    "phone": "+34 600 000 000",
    "website": "https://casasol.es",
    "country": "ES",
    "listingsCount": 85
  }'
Mező Kötelező Jelentés
externalId Kötelező Az ügyfél azonosítója az Ön rendszerében (például a fiókja vagy a cége azonosítója a szoftverében). 1–100 karakter.
name Kötelező Cégnév (legfeljebb 120 karakter).
email Kötelező Az ügyfél kapcsolattartási e-mail-címe. Ha az ügyfél új az Anutón, ebből jön létre az Anuto-fiókja.
country Kötelező Kétbetűs ISO-országkód, például ES.
phone Opcionális Elérhetőségi telefonszám (legfeljebb 40 karakter).
website Opcionális Az ügyfél weboldala, http vagy https.
format Opcionális Csak akkor kell, ha a hozzáférése több integrációt fed le.
connection Opcionális Az integrációjához szükséges kapcsolati mezők, ha vannak. Hogy melyek, azt a hozzáférése jóváhagyásakor közöljük.
listingsCount Opcionális Az ügyfél hirdetéseinek száma, tervezéshez.
test Opcionális Csak érvényesíti az adatokat és ellenőrzi a kapcsolatot. Nem jön létre semmi.

Válasz

Minden hívás visszaadja az ügyfél állapotát, a hirdetésszámokat és a csomagot.

{
  "externalId": "12345",
  "clientId": "Xw3kQ9mZr2LpT7vNa4Bc",
  "status": "active",
  "shopUrl": "https://es.anuto.app/@casa-sol",
  "listings": { "active": 10, "waiting": 0, "planWaiting": 75 },
  "plan": { "tier": "free", "maxActive": 10, "freeMaxActive": 10 },
  "upgradeUrl": "https://es.anuto.app/user/manage/plan",
  "lastSyncAt": "2026-10-08T09:30:00.000Z"
}

Egy ügyfél állapotának lekérdezése

GET/provider/clients/{externalId}

Visszaadja az ügyfél aktuális állapotát, a hirdetések számát és a csomagot, ugyanabban a formában, mint az aktiválás válasza.

curl https://api.anuto.app/v1/provider/clients/12345 \
  -H "Authorization: Bearer $ANUTO_KEY"

Ügyfél deaktiválása

DELETE/provider/clients/{externalId}

Az ügyfél törlése kikapcsolja, és visszavonja a hirdetéseit az Anutóról.

curl -X DELETE https://api.anuto.app/v1/provider/clients/12345 \
  -H "Authorization: Bearer $ANUTO_KEY"

Változások jelzése

POST/provider/clients/{externalId}/changes

Hívja meg, valahányszor változik egy ügyfél készlete: hirdetés jön létre, módosul, elkel vagy törlődik. Az ügyfelet perceken belül újraszinkronizáljuk, ahelyett, hogy megvárnánk a néhány óránként futó rendszeres szinkront. Az 5 percen belüli hívásokat összevonjuk, így minden változásnál hívhatja.

  • A törzs nem kötelező. Az itemIds mezővel legfeljebb 100, megváltozott ingatlan- vagy termékazonosítóját adhatja meg.
  • Sikeres hívás 202-t ad vissza. A nextSyncAt az az időpont (UTC), amikor az újraszinkronizálás esedékes.
  • Inaktív ügyfél esetén a válasz queued: false értéket és üzenetet tartalmaz. Semmi sem kerül sorba.
curl -X POST https://api.anuto.app/v1/provider/clients/12345/changes \
  -H "Authorization: Bearer $ANUTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "itemIds": ["123", "456"] }'
{
  "queued": true,
  "nextSyncAt": "2026-10-08T12:00:00Z"
}

Kulcs ellenőrzése

GET/provider/me

Visszaadja a szolgáltatója nevét, a hozzáférésével lefedett formátumokat és a kulcs állapotát. Új kulcs működését először ezzel ellenőrizze.

curl https://api.anuto.app/v1/provider/me \
  -H "Authorization: Bearer $ANUTO_KEY"
{
  "providerId": "Xw3kQ9mZr2LpT7vNa4Bc",
  "name": "Your software company",
  "formats": ["…"],
  "status": "approved"
}

Tesztmód

Állítsa a test mezőt true értékre az adatok érvényesítéséhez és a kapcsolat ellenőrzéséhez. Nem jön létre semmi: megkapja a várható állapotot és az ellenőrzések eredményét.

{
  "externalId": "12345",
  "name": "Casa Sol Real Estate",
  "email": "[email protected]",
  "country": "ES",
  "test": true
}

{
  "ok": true,
  "wouldBe": "active",
  "checks": { "connection": "ok", "owner": "new_account" }
}

Ügyfélállapotok

  • activeÉlő és szinkronizál.
  • pendingA kapcsolat még nem működik, ezért semmi nem jelenik meg.
  • reviewAz Anuto átnézi, mert ennek az új ügyfélnek az e-mail-címe már egy másik Anuto-fiókhoz tartozik.
  • inactiveÖn kikapcsolta, vagy az Anuto eltávolította.

Hibák

A sikertelen hívások JSON-t adnak statusCode, code és message mezőkkel. A code alapján döntse el a teendőt; a message emberi olvasásra szól.

{
  "statusCode": 404,
  "code": "PROVIDER_CLIENT_NOT_FOUND",
  "message": "No client with externalId 12345"
}
Kód HTTP Jelentés
PROVIDER_KEY_INVALID401Hiányzó, hibás vagy ismeretlen kulcs.
PROVIDER_REVOKED403Az Anuto visszavonta a szolgáltatói hozzáférését.
PROVIDER_FORMAT_REQUIRED400A szoftvere több formátumot kezel, ezért a kérésben szükség van a format mezőre.
PROVIDER_FORMAT_NOT_ALLOWED400A formátum nincs a jóváhagyott formátumai között.
PROVIDER_CLIENT_NOT_FOUND404A szolgáltatójánál nincs ilyen externalId-jú ügyfél.

Hívási korlátok

A korlát túllépésekor 429-es választ kap Retry-After fejléccel. Várjon ennyi másodpercet, majd próbálja újra.

Kérdése van az API-val vagy a hozzáférésével kapcsolatban? [email protected]