Przejdź do głównej treści

​
Wprowadzenie

Identity to usługa uwierzytelniania oferowana przez Ace Data Cloud, umożliwiająca weryfikację tożsamości za pomocą dowodu osobistego, karty bankowej lub numeru telefonu. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko wywołać Identity za pomocą cURL, realizując funkcje takie jak OCR dowodu osobistego, weryfikacja dowodu osobistego, weryfikacja karty bankowej oraz weryfikacja numeru telefonu.

​
Wymagania wstępne

  • Posiadanie konta w Ace Data Cloud oraz uzyskanie tokenu API
  • Środowisko terminalowe z zainstalowanym cURL

​
Podstawowe użycie

Główny endpoint API Identity to: 
POST https://api.acedata.cloud/identity/idcard/ocr
Przykładowe pełne polecenie cURL: 
curl -X POST https://api.acedata.cloud/identity/idcard/ocr \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/idcard-front.jpg"}'
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

​
Przykład odpowiedzi

Po pomyślnym wywołaniu zwracane są dane w formacie JSON, na przykład: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Przetwarzanie odpowiedzi za pomocą jq

Zaleca się użycie narzędzia jq do formatowania wyjścia: 
curl -s -X POST https://api.acedata.cloud/identity/idcard/ocr \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/idcard-front.jpg"}' | jq .

​
Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Nieautoryzowany, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczona częstotliwość żądań
500Wewnętrzny błąd serwera

​
Kolejne kroki