Skip to content

Manipulando documentos

Jump to bottom
Vinícius Pozzebon edited this page Oct 13, 2017 · 22 revisions

Versão 2.0.0

Upload com promise

[POST] /v2/upload/{ref_id}/

Input

  • {ref_id}
  • name
  • mime-type
  • upload_tipo_cod
  • data
  • checksum

Payload:

{
   "files":[
      {
         "name":"DOC0025.jpg",
         "mime-type":"image/jpeg",
         "upload_tipo_cod":[
            2,
            11
         ],
         "data":"/9j/4R1IRXhpZgAATU0AKgAAAAgADAEAAAMAAAABA80AAAEBAAMAAAABAmcAAAECAAMAAAADAAAAngEGAA..."
      }
   ],
   "checksum":"abcdddddd",
   "device":{
      "id":"4782b0e77c00b724",
      "log":{
         "ip":"192.168.234.104",
         "lat":"-7.983676666666666",
         "lon":"-34.83896666666667"
      }
   }
}

Retorno:

O endpoint retornará uma "promise" para o upload enviado, conforme exemplo abaixo:

{
   "success":true,
   "data":{
      "StorageAPI":{
         "send_id":"abcd123",
         "timestamp_start":121212333,
         "timestamp_end":null,
         "send_status_code":206,
         "files":[
            {
               "file_id":"{hash}",
               "name":"DOC0025.jpg",
               "timestamp_start":123123123,
               "timestamp_end":null,
               "status_code":202,
               "url":null,
               "width":null,
               "height":null,
               "upload_tipo_cod":[
                  0
               ]
            },
            {
               "file_id":"{hash}",
               "name":"DOC0026.jpg",
               "timestamp_start":123123123,
               "timestamp_end":321321321,
               "status_code":201,
               "url":"https://s3.amazonaws.com/{hash}.jpg",
               "width":970,
               "height":615,
               "upload_tipo_cod":[
                  0
               ]
            },
            {
               "file_id":"{hash}",
               "name":"DOC0027.jpg",
               "timestamp_start":123123123,
               "timestamp_end":321321321,
               "status_code":415,
               "url":null,
               "width":null,
               "height":null,
               "upload_tipo_cod":[
                  0
               ]
            }
         ]
      }
   }
}

Consultando a lista de promises de um {ref_id}

[GET] /v2/promises/{ref_id}/

Retorno:

{
   "success":true,
   "data":{
      "StorageAPI":{
         "promises":[
            {
               "send_id":"abcd000",
               "timestamp_start":121212333,
               "timestamp_end":1211212334,
               "send_status_code":200,
               "files":[
                  {
                     "file_id":"{hash}",
                     "name":"DOC0025.jpg",
                     "timestamp_start":123123123,
                     "timestamp_end":null,
                     "status_code":201,
                     "url":"https://s3.amazonaws.com/{hash}.jpg",
                     "width":970,
                     "height":615,
                     "upload_tipo_cod":[
                        1
                     ]
                  }
               ]
            },
            {
               "send_id":"abcd123",
               "timestamp_start":121212333,
               "timestamp_end":1211212334,
               "send_status_code":200,
               "files":[
                  {
                     "file_id":"{hash}",
                     "name":"DOC0025.jpg",
                     "timestamp_start":123123123,
                     "timestamp_end":null,
                     "status_code":201,
                     "url":"https://s3.amazonaws.com/{hash}.jpg",
                     "width":970,
                     "height":615,
                     "upload_tipo_cod":[
                        1
                     ]
                  },
                  {
                     "file_id":"{hash}",
                     "name":"DOC0026.jpg",
                     "timestamp_start":123123123,
                     "timestamp_end":321321321,
                     "status_code":201,
                     "url":"https://s3.amazonaws.com/{hash}.jpg",
                     "width":970,
                     "height":615,
                     "upload_tipo_cod":[
                        1,
                        2
                     ]
                  },
                  {
                     "file_id":"{hash}",
                     "name":"DOC0027.jpg",
                     "timestamp_start":123123123,
                     "timestamp_end":321321321,
                     "status_code":415,
                     "url":null,
                     "width":null,
                     "height":null,
                     "upload_tipo_cod":[
                        0
                     ]
                  }
               ]
            }
         ]
      }
   }
}

Consultando o status de uma promise

[GET] /v2/promise/{send_id}/

Retorno:

{
   "success":true,
   "data":{
      "StorageAPI":{
         "send_id":"abcd123",
         "timestamp_start":121212333,
         "timestamp_end":1211212334,
         "send_status_code":200,
         "files":[
            {
               "file_id":"{hash}",
               "name":"DOC0025.jpg",
               "timestamp_start":123123123,
               "timestamp_end":null,
               "status_code":201,
               "url":"https://s3.amazonaws.com/{hash}.jpg",
               "width":970,
               "height":615,
               "upload_tipo_cod":[
                  1
               ]
            },
            {
               "file_id":"{hash}",
               "name":"DOC0026.jpg",
               "timestamp_start":123123123,
               "timestamp_end":321321321,
               "status_code":201,
               "url":"https://s3.amazonaws.com/{hash}.jpg",
               "width":970,
               "height":615,
               "upload_tipo_cod":[
                  1
               ]
            },
            {
               "file_id":"{hash}",
               "name":"DOC0027.jpg",
               "timestamp_start":123123123,
               "timestamp_end":321321321,
               "status_code":415,
               "url":null,
               "width":null,
               "height":null,
               "upload_tipo_cod":[
                  0
               ]
            }
         ]
      }
   }
}

Explicando:

A posição "send_status_code" retorna o status code que identifica se o lote foi aceito para processamento ou não:

  • 200, caso o lote todo já tenha sido processado;
  • 206, caso algum dos arquivos do lote ainda esteja sendo processado;
  • 40*, em caso de erros de requisição do front-end;
  • 50*, em caso de erro interno no back-end;

Individualmente, cada arquivo remetido também retorna um status code que identifica se o arquivo foi processado com sucesso, se está aguardando processamento ou se foi recusado pela API.

  • 201, em caso de sucesso;
  • 202, caso tenha sido aceito para processamento;
  • 40*, caso o front-end tenha submetido uma requisição inconsistente;
  • 415, caso o formato de arquivo remetido não seja suportado;
  • 50*, caso durante o processamento do arquivo, o back-end tenha encontrado uma exceção não tratada;

Obtendo a lista de todos os documentos de uma {ref_id}

[GET] /v2/docs/{ref_id}/

Input

  • {ref_id}

Output

{
   "success":true,
   "data":{
      "StorageAPI":{
         "data_hora_cache":"2017-01-01 20:50:48",
         "files":[
            {
               "file_id":"{hash}",
               "name":"DOC0025.jpg",
               "mime-type":"image/jpeg",
               "url":"url-do-arquivo.jpg",
               "width":675,
               "height":325,
               "coordinate_x":90,
               "coordinate_y":120,
               "rotate":90.00,
               "upload_tipo_cod":[
                  0,
                  3,
                  8
               ],
               "author":{
                  "oid":"{oid}",
                  "uupfid":"{uupfid}",
                  "nome":"Nome do autor",
                  "timestamp":123123
               }
            },
            {
               "file_id":"{hash}",
               "name":"DOC0028.jpeg",
               "mime-type":"image/jpeg",
               "url":"url-do-arquivo.jpg",
               "width":300,
               "height":320,
               "coordinate_x":90,
               "coordinate_y":120,
               "rotate":90.00,
               "upload_tipo_cod":[
                  2,
                  4
               ],
               "author":{
                  "oid":"{oid}",
                  "uupfid":"{uupfid}",
                  "nome":"Nome do autor",
                  "timestamp":123123
               }
            }
         ]
      }
   }
}

Consultando documentos de uma {ref_id} pelo tipo de documento

Obsoleto

[GET] /v2/docs/{ref_id}/{upload_tipo_cod}/

Input

  • {ref_id}
  • {upload_tipo_cod}

Output

Abaixo vemos o exemplo de uma requisição de retornar documentos de uma determinada {ref_id} onde o {upload_tipo_cod} requisitado foi "3":

{
   "success":true,
   "data":{
      "StorageAPI":{
         "files":[
            {
               "file_id":"{hash}",
               "name":"DOC0025.jpg",
               "mime-type":"image/jpeg",
               "url":"url-do-arquivo.jpg",
               "width":675,
               "height":325,
               "upload_tipo_cod":[
                  0,
                  3,
                  8
               ]
            }
         ]
      }
   }
}

Obtendo os detalhes de um documento

[GET] /v2/doc/{ref_id}/{file_id}/

Input

  • {file_id}

Output

{
    "success": true,
    "data": {
        "StorageAPI": {
            "file": {
                "file_id": "69f65b3072f0eb0a0cd104f55d3420.jpg",
                "name": "1(1160).jpg",
                "url": "https://alpha-onxerp.s3-accelerate.amazonaws.com/69f65b3072f0eb0a0cd104f55d3420.jpg",
                "coordinate_x": null,
                "coordinate_y": null,
                "width": 1370,
                "height": 587,
                "rotate": null,
                "upload_tipo_cod": [
                    99
                ]
            },
            "author": {
                "oid": null,
                "uupfid": "ddf80ed94f74ff96810f4f8f3e0de6",
                "nome": "Filipe Torres 2",
                "timestamp": 1507243911
            }
        }
    }
}

Alterando o tipo de um documento

[PATCH] /v2/doc/doc-type/{file_id}/

Input

  • {file_id}
  • [upload_tipo_cod]

Output

{
   "file":{
      "file_id":"{hash}",
      "upload_tipo_cod":[
         2,
         3
      ]
   }
}

Alterando meta data de uma imagem

PUT /v2/doc/meta/{file_id}/

Payload:

{
   "width":675,
   "height":325,
   "coordinate_x":90,
   "coordinate_y":120
}

Alterando a rotação de uma imagem

PUT /v2/doc/meta/rotate/{file_id}/

Payload:

{
   "rotate":-90.00,
}

Removendo um documento

[DELETE] /v2/doc/{file_id}/delete/

Input

  • {file_id}

Output

Status code:

  • 200, em caso de sucesso;
  • 40*, em caso de erros de requisição do front-end;
  • 50*, em caso de erro interno no back-end;

Clone this wiki locally