Docs

EnterpriseModel i razvoj

Razvoj

API ključevi, potrošnja, log zahtjeva i webhookovi vašeg sistema, sve na platformi.

API ključevi: produkcija ovog mjeseca 1.170 jedinica, tri ključa s pristupom, potrošnjom, 14 dana zahtjeva i statusom

Pregled

Razvoj je mjesto za integraciju s Cifra API-jem: ključevi, potrošnja, zahtjevi i webhookovi. Tu su i Widgeti, vaša vozila na vašoj stranici. Vide ga i mijenjaju vlasnici i administratori. API je dio Business (10.000 jedinica mjesečno, dijeljeno između produkcijskih ključeva) i Enterprise plana.

Ugovor je na vrhu API ključevi i Upotreba: potrošnja produkcijskih jedinica ovog mjeseca prema kvoti, tempo do kraja mjeseca i brzina (zahtjeva u minuti).

Novi ključ

  1. 1

    Napravite ključ

    Novi ključ: naziv, okruženje (Test: fiksni primjeri, bez troška; Produkcija: prave procjene, troše jedinice) i usluge (Procjene, Praćenje vozila, Provjera vozila). Pod Ograničenja i sigurnost su mjesečni limit jedinica, dozvoljene IP adrese (CIDR), datum isteka i napomena.

    Novi API ključ: naziv, okruženje Test ili Produkcija i usluge Procjene, Praćenje vozila i Provjera vozila
  2. 2

    Sačuvajte ga

    Ključ se prikazuje samo jednom, uz cURL, JavaScript i Python primjer za probu. Panel se ne zatvara dok ne potvrdite Ključ je sačuvan na sigurnom.

    Ključ je spreman: token prikazan jednom i cURL primjer za probu

Jedan ključ

Stranica ključa ima Pregled (mjesec prema limitu, 30 dana zahtjeva, jedinica i grešaka, po usluzi, najčešće greške i zadnji zahtjevi), Postavke i Historija. Radnje:

  • Zamijeni: novi token s istim postavkama, a stari radi još neko vrijeme (odmah, 1 h, 24 h ili 7 dana).
  • Pauziraj: ključ dobija 403 key_paused dok ga ne nastavite.
  • Opozovi: zauvijek. Ključ korišten u zadnjoj sedmici traži da upišete njegov naziv.
Ključ DMS integracija: 1.094 jedinice ovaj mjesec, 230 zahtjeva u 30 dana, 4,8% grešaka i zahtjevi po danu

Upotreba

Jedinice, zahtjevi, stopa grešaka i vrijeme odgovora za ovaj ili prošli mjesec, ili 7, 30 i 90 dana; po danu i usluzi, po endpointu i po ključu, i greške koje su dobili vaši sistemi, svaka s linkom na zahtjeve. CSV za Excel. Pod Obavijesti emailom su pragovi potrošnje (50–100%) i dodatne adrese za obavijesti API-ja.

Upotreba API-ja: 1.170 obračunatih jedinica, 234 zahtjeva, 3,4% grešaka, 86 ms i jedinice po danu

Zahtjevi

Log svih zahtjeva vaših ključeva u zadnjih 30 dana, najnoviji prvi, s filterima po ishodu, periodu, ključu, pozivu i ID-u zahtjeva ili šifri greške, i Uživo. Zahtjev se otvara sa strane: greška riječima, ID zahtjeva, ključ, trajanje, jedinice, adresa i klijent, tijelo odbijenog zahtjeva i cURL za ponavljanje.

Zahtjevi: log s vremenom, statusom, endpointom, ključem, trajanjem i jedinicama
Otvoren zahtjev 400: Neispravan zahtjev, mileage_km nedostaje, s ID-om zahtjeva i poslanim tijelom

Webhookovi

Webhookovi javljaju vašem sistemu čim se nešto desi: alarm za praćeno vozilo, dnevni izvještaj, nova procjena, provjera ili odluka, završena masovna lista, potrošnja kvote. Svaki događaj je potpisan.

  1. 1

    Dodajte adresu

    Dodaj adresu: URL (https, javna adresa, provjerena dok kucate), opis, okruženje i svi ili odabrani događaji.

    Dodaj adresu: URL, opis, okruženje Produkcija ili Test i svi događaji
  2. 2

    Provjerite potpis

    Dobijate tajnu za potpis i kod za provjeru zaglavlja Cifra-Signature u Node.js, Pythonu, PHP-u i C#. Zatim Pošalji test šalje primjer bilo kojeg događaja.

    Adresa je dodana: tajna za potpis i kod za provjeru potpisa u Node.js

Stranica adrese ima zdravlje (uspješnost i vrijeme odgovora za 7 dana, isporuke po danu), Isporuke sa svakim pokušajem i odgovorom i Pošalji ponovo, Postavke, Potpis (otkrivanje i zamjena tajne, uz period u kojem potpisuju obje) i Historija. Neuspjela slanja ponavljamo oko dva dana; adresu koja tri dana ništa ne primi isključujemo i javljamo emailom.

Webhook adresa example.com/hooks/cifra: isporuke, uspješnost, vrijeme odgovora i događaji na čekanju

Sve vrste događaja s primjerima su u Događaji i u API referenci.

Događaji: omotnica događaja (id, type, created_at, livemode, data, test) i događaji praćenih vozila

Česta pitanja

Koliko ključeva možemo imati?

Do 50, u testnom i produkcijskom okruženju zajedno.

Troše li testni ključevi jedinice?

Ne. Testni ključ provjerava zahtjeve kao pravi i vraća fiksne primjere. Vidi Sandbox.

Ključ koji je napravila Cifra.

Ključeve koje je izdao Cifrin tim vidite s autorom „Cifra”. Ponašaju se kao vaši, a pauza koju postavi Cifra ne može se skinuti ovdje.

Gdje je tehnička dokumentacija?

U Cifra API vodičima i API referenci, s primjerima u sedam jezika i Isprobaj za svaki endpoint.