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 oraz numeru telefonu. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować Identity w Pythonie, realizując funkcje takie jak OCR dowodu osobistego, weryfikacja dowodu, karty bankowej oraz numeru telefonu.

​
Wymagania wstępne

  • Posiadanie konta w Ace Data Cloud oraz uzyskanie tokenu API
  • Środowisko Python 3.7 lub nowsze
  • Zainstalowana biblioteka requests: pip install requests

​
Podstawowe użycie

Główny endpoint API Identity to: 
POST https://api.acedata.cloud/identity/idcard/ocr
Pełny przykład kodu w Pythonie: 
import requests

url = "https://api.acedata.cloud/identity/idcard/ocr"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "image_url": "https://example.com/idcard-front.jpg"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

​
Obsługa odpowiedzi

Po pomyślnym wywołaniu API zwraca dane w formacie JSON. Zaleca się sprawdzenie kodu statusu HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Wywołanie zakończone sukcesem:", result)
else:
    print(f"Wywołanie nie powiodło się, kod statusu: {response.status_code}")
    print(response.text)

​
Zaawansowane użycie

Dla API obsługujących zadania asynchroniczne można uzyskać wynik poprzez URL zwrotny (callback): 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Wynik zostanie przesłany na Twój serwer przez callback URL

​
Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Błąd uwierzytelniania, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczono limit zapytań
500Błąd wewnętrzny serwera

​
Inne endpointy

Usługa Identity oferuje również następujące endpointy:
  • POST https://api.acedata.cloud/identity/idcard/check-1e
  • POST https://api.acedata.cloud/identity/bankcard/check-1e
  • POST https://api.acedata.cloud/identity/phone/check-1e

​
Kolejne kroki