Email címek lekérése UUID alapján

Vedd fel velünk a kapcsolatot ezen a számon: +36-30-925-6635

API hívása

A FindGore által biztosított Natív API kliens getEmailsOfProfile hívásával lehet lekérni egy konkrét profilhoz társított összes email címet.

 FindGoreNativeClient::getEmailsOfProfile(API_USER, API_PASS, DOMAIN, UUID)

A híváshoz meg kell adni, hogy melyik domain melyik profiljára vagyunk kíváncsiak. Az UUID formátuma lehet 36 karakteres formázott (123e4567-e89b-12d3-a456-426655440000) vagy 32 karakteres rövidített (123e4567e89b12d3a456426655440000).

Sikeres hívás eredménye

Egy hívás akkor sikeres, ha létezik a profil, amit keresünk. Ekkor a hívás eredménye  a következőképpen néz ki:

 
array (size=4)
  'responseHeaders' => 
    array (size=7)
      0 => string 'HTTP/1.1 200 OK' (length=15)
      1 => string 'Date: Mon, 07 Nov 2016 11:08:49 GMT' (length=35)
      2 => string 'Server: Apache/2.4.10 (Debian)' (length=30)
      3 => string 'Set-Cookie: PHPSESSID=.............................; path=/' (length=56)
      4 => string 'Cache-Control: no-cache' (length=23)
      5 => string 'Transfer-Encoding: chunked' (length=26)
      6 => string 'Content-Type: application/json' (length=30)
  'status' => int 200
  'errorCode' => int 0
  'response' => 
    array (size=1)
      0 => string 'info@test.hu' (length=12)
      

Akkor is sikeres egy hívás, ha a profil létezik, de nincs még hozzá email cím azonosítva:

array (size=4)
  'responseHeaders' => 
    array (size=7)
      0 => string 'HTTP/1.1 200 OK' (length=15)
      1 => string 'Date: Mon, 07 Nov 2016 11:08:49 GMT' (length=35)
      2 => string 'Server: Apache/2.4.10 (Debian)' (length=30)
      3 => string 'Set-Cookie: PHPSESSID=.............................; path=/' (length=56)
      4 => string 'Cache-Control: no-cache' (length=23)
      5 => string 'Transfer-Encoding: chunked' (length=26)
      6 => string 'Content-Type: application/json' (length=30)
  'status' => int 200
  'errorCode' => int 0
  'response' => 
    array(size=0)
      empty
 

Sikertelen hívások oka és eredménye

A hibák paraméterei a manuális problémamegoldást segítik, a gépi hibakezeléshez a HTTP státuszt, és a hibák kulcsait érdemes használni, amik egyértelműen meghatározzák, hogy milyen típusú hiba történt.

Nincs domain meghatározva

Ok: üres domain paraméterrel lett meghívva az API

array (size=4)
  'responseHeaders' => 
    array (size=7)
      0 => string 'HTTP/1.1 410 Gone' (length=17)
      1 => string 'Date: Mon, 07 Nov 2016 11:39:59 GMT' (length=35)
      2 => string 'Server: Apache/2.4.10 (Debian)' (length=30)
      3 => string 'Set-Cookie: PHPSESSID=.............................; path=/' (length=56)
      4 => string 'Cache-Control: no-cache' (length=23)
      5 => string 'Transfer-Encoding: chunked' (length=26)
      6 => string 'Content-Type: application/json' (length=30)
  'status' => int 410
  'errorCode' => int 0
  'response' => 
    array (size=1)
      'errors' => 
        array (size=1)
          'nodomain' => 
            array (size=2)
              'message' => string 'Domain not specified' (length=20)
              'user' => string 'test' (length=4)
 

A megadott domain-hez nem fér hozzá az API felhasználó

Ok: az API felhasználóknál külön engedélyezni kell, hogy melyik domain adatait érheti el az API felületen. Ezt a FindGore csapata tudja beállítani, amennyiben egy API felhasználóval szeretne elérni egy konkrét domain-t, az email-ben jelezze a support@webbandflow.co.uk címen. Az email-ben mindenképpen írja meg az API felhasználó nevet és a domain-t, amit el szeretne érni.

array (size=4)
  'responseHeaders' => 
    array (size=7)
      0 => string 'HTTP/1.1 403 Forbidden' (length=22)
      1 => string 'Date: Mon, 07 Nov 2016 11:41:22 GMT' (length=35)
      2 => string 'Server: Apache/2.4.10 (Debian)' (length=30)
      3 => string 'Set-Cookie: PHPSESSID=.............................; path=/' (length=56)
      4 => string 'Cache-Control: no-cache' (length=23)
      5 => string 'Transfer-Encoding: chunked' (length=26)
      6 => string 'Content-Type: application/json' (length=30)
  'status' => int 403
  'errorCode' => int 0
  'response' => 
    array (size=1)
      'errors' => 
        array (size=1)
          'accessDenied' => 
            array (size=3)
              'message' => string 'You can't access test.hu domain's data' (length=41)
              'user' => string 'test' (length=7)
              'domain' => string 'test.hu' (length=7)

Nincs uuid meghatározva

Ok: üres uuid paraméterrel lett meghívva az API

array (size=4)
  'responseHeaders' => 
    array (size=7)
      0 => string 'HTTP/1.1 410 Gone' (length=17)
      1 => string 'Date: Mon, 07 Nov 2016 11:46:22 GMT' (length=35)
      2 => string 'Server: Apache/2.4.10 (Debian)' (length=30)
      3 => string 'Set-Cookie: PHPSESSID=.............................; path=/' (length=56)
      4 => string 'Cache-Control: no-cache' (length=23)
      5 => string 'Transfer-Encoding: chunked' (length=26)
      6 => string 'Content-Type: application/json' (length=30)
  'status' => int 410
  'errorCode' => int 0
  'response' => 
    array (size=1)
      'errors' => 
        array (size=1)
          'nouuid' => 
            array (size=3)
              'message' => string 'UUID not specified' (length=18)
              'user' => string 'test' (length=4)
              'domain' => string 'test.hu' (length=7)

Nem található a profil

Ok: a megadott uuid-val nem található profil az adott domain adatai közt

array (size=4)
  'responseHeaders' => 
    array (size=7)
      0 => string 'HTTP/1.1 410 Gone' (length=17)
      1 => string 'Date: Mon, 07 Nov 2016 11:49:06 GMT' (length=35)
      2 => string 'Server: Apache/2.4.10 (Debian)' (length=30)
      3 => string 'Set-Cookie: PHPSESSID=.............................; path=/' (length=56)
      4 => string 'Cache-Control: no-cache' (length=23)
      5 => string 'Transfer-Encoding: chunked' (length=26)
      6 => string 'Content-Type: application/json' (length=30)
  'status' => int 410
  'errorCode' => int 0
  'response' => 
    array (size=1)
      'errors' => 
        array (size=1)
          'noprofile' => 
            array (size=4)
              'message' => string 'Profile with UUID 01234567890123456789012345678901 not found' (length=60)
              'user' => string 'test' (length=7)
              'domain' => string 'test.hu' (length=15)
              'uuid' => string '01234567890123456789012345678901' (length=32)