AzureCognitiveBinder

1. A binder REST service for Azure Cognitive APIs.These Binder APIs can be called from both Mobile and Web applications using corresponding client libraries.
2. Dockerfile is included which would help containerize the service and also can be used seamlessly with Azure Container Registry or Docker Cloud or running locally. This would help in local testing and then hosting in Azure as Web API (or any other hosting services)
3. No need to send Storage account details as part of the request (although that option is open); these secured information can be in Azure Web API layer and service can read from process.env dictionary
4. Server host address is kept at 0.0.0.0 - so that it can be accesses from containerized hosting solutions like Docker Swarm

API Endpoints:

Default

URL - https://<host_server_details>
GET request body - { }

FACE APIs

1. URL - https://<host_server_details>/face//detect
   POST request body -

   {
     "faceURL" : <FACE_IMAGE_URL>, // OR, "imageData" : <BASE64_IMAGE_BYTES>
     "options": <OPTION>
   }
   
   

2. URL - https://<host_server_details>/face/find
   POST request body -

   {
     "faceId" : <FACE_IDENTIFIER>,
     "options": <OPTION>
   }
   
   

3. URL - https://<host_server_details>/face/group
   POST request body -

   {
     "faceIds" : [<FACE_IDENTIFIER>],
     "options": <OPTION>
   }
   
   

4. URL - https://<host_server_details>/face/identify
   POST request body -

   {
     "faceIds" : [<FACE_IDENTIFIER>],
     "personGroupId" : [<PERSON_GROUP_IDENTIFIER>],
     "options": <OPTION>
   }
   
   

5. URL - https://<host_server_details>/face/verify
   POST request body -

   {
     "faceId1" : <FACE_IDENTIFIER_1>,
     "faceId2" : <FACE_IDENTIFIER_2>,
     "options": <OPTION>
   }
   
   

6. URL - https://<host_server_details>/face/verify/personGroup
   POST request body -

   {
     "faceId" : <FACE_IDENTIFIER>,
     "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
     "personId" : <PERSON_IDENTIFIER>,
     "options": <OPTION>
   }
   
   

7. URL - https://<host_server_details>/face/personGroup/create
   PUT request body -

   {
     "personGroupName" : <PERSON_GROUP_NAME>,
     "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
     "options": <OPTION>
   }
   
   

8. URL - https://<host_server_details>/face/personGroup/update
   POST request body -

   {
     "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
     "options": <OPTION>
   }
   
   

9. URL - https://<host_server_details>/face/personGroup/delete
   DELETE request body -

   {
     "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
     "options": <OPTION>
   }
   
   

10. URL - https://<host_server_details>/face/personGroup/fetch
    POST request body -

    {
      "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
      "options": <OPTION>
    }
    
    

11. URL - https://<host_server_details>/face/personGroup/list
    POST request body -

    {
      "options": <OPTION>
    }
    
    

12. URL - https://<host_server_details>/face/personGroup/train
    POST request body -

    {
      "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
      "options": <OPTION>
    }
    
    

13. URL - https://<host_server_details>/face/personGroup/person/create
    PUT request body -

    {
      "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
      "personName" : <PERSON_NAME>,
      "options": <OPTION>
    }
    
    

14. URL - https://<host_server_details>/face/personGroup/person/update
    POST request body -

    {
      "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
      "personId" : <PERSON_IDENTIFIER>,
      "options": <OPTION>
    }
    
    

15. URL - https://<host_server_details>/face/personGroup/person/delete
    DELETE request body -

    {
      "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
      "personId" : <PERSON_IDENTIFIER>,
      "options": <OPTION>
    }
    
    

16. URL - https://<host_server_details>/face/personGroup/person/fetch
    POST request body -

    {
      "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
      "personId" : <PERSON_IDENTIFIER>,
      "options": <OPTION>
    }
    
    

17. URL - https://<host_server_details>/face/personGroup/person/list
    POST request body -

    {
      "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
      "options": <OPTION>
    }
    
    

18. URL - https://<host_server_details>/face/personGroup/person/add
    PUT request body -

    {
      "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
      "personId" : <PERSON_IDENTIFIER>,
      "targetFace" : <TARGET_FACE_IDENTIFIER>,
      "imageData" : <BASE64_IMAGE_BYTES>,
      "options": <OPTION>
    }
    
    

19. URL - https://<host_server_details>/face/add
    PUT request body -

    {
      "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
      "personGroupName" : <PERSON_GROUP_NAME>,
      "options": <OPTION>
    }
    
    

20. URL - https://<host_server_details>/face/update
    POST request body -

    {
      "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
      "personId" : <PERSON_IDENTIFIER>,
      "persistedFaceId" : <PERSISTENT_FACE_IDENTIFIER>,
      "options": <OPTION>
    }
    
    

21. URL - https://<host_server_details>/face/delete
    DELETE request body -

    {
      "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
      "personId" : <PERSON_IDENTIFIER>,
      "persistedFaceId" : <PERSISTENT_FACE_IDENTIFIER>,
      "options": <OPTION>
    }
    
    

22. URL - https://<host_server_details>/face/fetch
    POST request body -

    {
      "personGroupId" : <PERSON_GROUP_IDENTIFIER>,
      "personId" : <PERSON_IDENTIFIER>,
      "persistedFaceId" : <PERSISTENT_FACE_IDENTIFIER>,
      "options": <OPTION>
    }
    
    

COMPUTERVISION APIs

1. URL - https://<host_server_details>/computerVision/ocr
   POST request body -

   {
     "detectOrientation" : <TRUE/FALSE>,      
     "imageURL" : <IMAGE_URL>, // OR "imageData" : <BASE64_IMAGE_BYTES>     
     "options": <OPTION>
   }
   
   

2. URL - https://<host_server_details>/computerVision/text
   POST request body -

   {
     "imageURL" : <IMAGE_URL>, // OR "imageData" : <BASE64_IMAGE_BYTES>     
     "options": <OPTION>
   }
   
   

3. URL - https://<host_server_details>/computerVision/tags
   POST request body -

   {
     "imageURL" : <IMAGE_URL>, // OR "imageData" : <BASE64_IMAGE_BYTES>     
     "options": <OPTION>
   }
   
   

4. URL - https://<host_server_details>/computerVision/thumbnails
   POST request body -

   {
     "imageWidth" : <IMAGE_WIDTH>,
     "imageHeight" : <IMAGE_HEIGHT>,
     "imageURL" : <IMAGE_URL>, // OR "imageData" : <BASE64_IMAGE_BYTES>     
     "options": <OPTION>
   }
   
   

5. URL - https://<host_server_details>/computerVision/describe
   POST request body -

   {
     "imageURL" : <IMAGE_URL>, // OR "imageData" : <BASE64_IMAGE_BYTES>     
     "options": <OPTION>
   }
   
   

6. URL - https://<host_server_details>/computerVision/analyze
   POST request body -

   {
     "imageURL" : <IMAGE_URL>, // OR "imageData" : <BASE64_IMAGE_BYTES>     
     "options": <OPTION>
   }
   
   

TEXTANALYTICS APIs

1. URL - https://<host_server_details>/textAnalytics/language
   POST request body -

   {
     "input" : <LANGUAGE_INPUT>,      
     "options": <OPTION>
   }
   
   

2. URL - https://<host_server_details>/textAnalytics/keyphrases
   POST request body -

   {
     "input" : <KEYPHRASE_INPUT>,      
     "options": <OPTION>
   }
   
   

3. URL - https://<host_server_details>/textAnalytics/sentiment
   POST request body -

   {
     "input" : <SENTIMENT_INPUT>,      
     "options": <OPTION>
   }